{"info":{"_postman_id":"d0aae761-6651-474b-85ff-af970d5c081d","name":"Asterium API","description":"

API para gestionar usuarios y descubrimientos astronómicos.

Incluye autenticación JWT y roles (admin y user).

\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"46421564","collectionId":"d0aae761-6651-474b-85ff-af970d5c081d","publishedId":"2sB3QNqU8X","public":true,"customColor":{"top-bar":"0B0F24","right-sidebar":"1A1D2E","highlight":"FF6C37"},"publishDate":"2025-10-16T10:48:07.000Z"},"item":[{"name":"Registrar usuario","id":"b0d71dbe-006d-4b98-af3f-f93e42474bf4","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"email\": \"astroUser@mail.com\",\r\n \"username\": \"astroUser\",\r\n \"password\": \"12345678\"\r\n}\r\n","options":{"raw":{"language":"json"}}},"url":"/auth/register","description":"

📘 Registrar usuario

Crea un nuevo usuario dentro del sistema Asterium.

Método: POST
URL: /auth/register

🔸 Body (JSON)

{\n  \"email\": \"astroUser@mail.com\",\n  \"username\": \"astroUser\",\n  \"password\": \"12345678\"\n}\n\n

🔹 Respuesta esperada (201 Created)

{\n  \"token\": \"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...\",\n  \"user\": {\n    \"id\": 1,\n    \"email\": \"astroUser@mail.com\",\n    \"username\": \"astroUser\"\n  }\n}\n\n

🔸 Errores posibles

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Código	Causa	Descripción
400	VALIDATION_ERROR	Datos inválidos (por ejemplo, email mal formado).
409	Conflict	El email ya está registrado.
500	Server Error	Error interno del servidor.

🧠 Notas

No requiere autenticación (Auth: none).
\n
El token devuelto deberá usarse para acceder a rutas protegidas (Bearer Token).
\n
La contraseña debe tener al menos 8 caracteres.
\n

🌠 Ejemplo visual

📍 Usa esta petición como primer paso antes de probar login o creación de descubrimientos.

\n","urlObject":{"path":["auth","register"],"host":[""],"query":[],"variable":[]}},"response":[],"_postman_id":"b0d71dbe-006d-4b98-af3f-f93e42474bf4"},{"name":"Login","id":"21532309-7327-4e50-8845-c12448f5c758","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"email\": \"astroUser@mail.com\",\r\n \"password\": \"12345678\"\r\n}\r\n","options":{"raw":{"language":"json"}}},"url":"/auth/login","description":"

StartFragment

\n\n

Permite al usuario autenticarse en el sistema y obtener un token JWT para acceder a rutas protegidas.

Método: POST
URL: /auth/login

🔸 Body (JSON)

{\n  \"email\": \"astroUser@mail.com\",\n  \"password\": \"12345678\"\n}\n\n

🔹 Respuesta esperada (200 OK)

{\n  \"token\": \"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...\",\n}\n\n

🔸 Errores posibles

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Código	Causa	Descripción
400	VALIDATION_ERROR	Datos inválidos (por ejemplo, formato de email incorrecto).
401	Unauthorized	Email o contraseña incorrectos.
500	Server Error	Error interno del servidor.

🧠 Notas

No requiere autenticación (Auth: none).
\n
El token devuelto se usará en las cabeceras Authorization: Bearer para rutas protegidas.
\n
El token tiene un tiempo de expiración configurado en el backend.
\n

🌠 Ejemplo visual

📍 Usa esta petición justo después de registrarte, para obtener tu token de acceso.

EndFragment

\n","urlObject":{"path":["auth","login"],"host":[""],"query":[],"variable":[]}},"response":[],"_postman_id":"21532309-7327-4e50-8845-c12448f5c758"},{"name":"Listar descubrimientos","id":"162b5579-39be-48f6-a746-09b58af246ca","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Content-Type","value":"application/json","type":"text"},{"key":"Authorization","value":"Bearer ","type":"text"}],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"/asterium","description":"

StartFragment

🌌 Listar descubrimientos

Devuelve una lista con todos los descubrimientos publicados por los usuarios.

Solo pueden acceder los usuarios autenticados (con token JWT válido).

Método: GET
Ruta: /asterium
Autenticación: ✅ Bearer Token

🔹 Ejemplo de respuesta (200 OK)

[\n    {\n        \"id\": 5,\n        \"author_id\": 8,\n        \"title\": \"Descubrimiento de celulas\",\n        \"slug\": \"exoplaneta-003\",\n        \"excerpt\": null,\n        \"content_md\": \"Se encontró un nuevo celulas 🌍\",\n        \"status\": \"published\",\n        \"published_at\": \"2025-09-30T15:27:08.000Z\",\n        \"like_count\": 0,\n        \"created_at\": \"2025-09-30T15:27:08.000Z\",\n        \"updated_at\": \"2025-09-30T15:27:08.000Z\"\n    },\n    {\n        \"id\": 4,\n        \"author_id\": 8,\n        \"title\": \"Descubrimiento de Matt\",\n        \"slug\": \"matt-002\",\n        \"excerpt\": null,\n        \"content_md\": \"Se encontró un nuevo Matt 🌍\",\n        \"status\": \"published\",\n        \"published_at\": \"2025-09-30T14:59:26.000Z\",\n        \"like_count\": 0,\n        \"created_at\": \"2025-09-30T14:59:26.000Z\",\n        \"updated_at\": \"2025-09-30T14:59:26.000Z\"\n    }\n]\n\n

🔸 Errores posibles

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Código	Causa	Descripción
401	Unauthorized	No se ha enviado token o es inválido.
403	Forbidden	El usuario no tiene permisos.
500	Server Error	Error interno del servidor.

🧠 Notas

Solo devuelve descubrimientos con estado \"published\".
\n
Incluye información del autor (username, email).
\n
Se recomienda usar esta petición antes de consultar un descubrimiento individual.
\n

🌠 Ejemplo visual

📍 Muestra todos los descubrimientos visibles del sistema, ordenados por fecha de publicación.

EndFragment

\n","urlObject":{"path":["asterium"],"host":[""],"query":[],"variable":[]}},"response":[],"_postman_id":"162b5579-39be-48f6-a746-09b58af246ca"},{"name":"Lista por ID","id":"d5b32d6f-fb50-46f6-bd86-5cb0cd70090e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Authorization","value":"Bearer ","type":"text"}],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"/asterium/","description":"

StartFragment

🌌 Detalle de descubrimiento

Devuelve la información detallada de un descubrimiento según su ID.

Método: GET
URL: /asterium/:id

🔹 Respuesta esperada (200 OK)

{\n    \"id\": 5,\n    \"author_id\": 8,\n    \"title\": \"Descubrimiento de celulas\",\n    \"slug\": \"exoplaneta-003\",\n    \"excerpt\": null,\n    \"content_md\": \"Se encontró un nuevo celulas 🌍\",\n    \"status\": \"published\",\n    \"published_at\": \"2025-09-30T15:27:08.000Z\",\n    \"like_count\": 0,\n    \"created_at\": \"2025-09-30T15:27:08.000Z\",\n    \"updated_at\": \"2025-09-30T15:27:08.000Z\",\n    \"author\": {\n        \"id\": 8,\n        \"username\": \"mar1234\",\n        \"email\": \"mar@test.com\"\n    }\n}\n\n

🔸 Errores posibles

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Código	Causa	Descripción
404	Not Found	No existe el descubrimiento.
401	Unauthorized	Token no válido o ausente.

🧠 Notas

Requiere autenticación.
\n
Se usa cuando el usuario hace clic en un elemento para ver su detalle.
\n

🌠 Ejemplo visual

📍 Usa este endpoint en la vista “detalle” del frontend.

EndFragment

\n","urlObject":{"path":["asterium",""],"host":[""],"query":[],"variable":[]}},"response":[],"_postman_id":"d5b32d6f-fb50-46f6-bd86-5cb0cd70090e"},{"name":"Crear descubrimiento","id":"0315e45f-aa47-412a-824d-c0bc84bd47ff","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Authorization","value":"Bearer ","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"title\": \"Descubrimiento de exoplanetas\",\r\n \"slug\": \"exoplaneta-007\",\r\n \"content_md\": \"Se encontró nuevos exoplanetas 🌍\",\r\n \"status\": \"draft\"\r\n}\r\n","options":{"raw":{"language":"json"}}},"url":"/asterium","description":"

StartFragment

🌌 Crear descubrimiento

Crea un nuevo descubrimiento en la base de datos.

Solo disponible para usuarios autenticados.

Método: POST
URL: /asterium

🔹 Respuesta esperada (201 Created)

{\n  \"title\": \"Descubrimiento de exoplanetas\",\n  \"slug\": \"exoplaneta-007\",\n  \"content_md\": \"Se encontró nuevos exoplanetas 🌍\",\n  \"status\": \"draft\"\n}\n\n

🔸 Errores posibles

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Código	Causa	Descripción
400	VALIDATION_ERROR	Datos incompletos o inválidos.
401	Unauthorized	Token inválido o ausente.

🧠 Notas

Requiere Auth: Bearer Token.
\n
Verifica que los campos requeridos estén completos.
\n

🌠 Ejemplo visual

📍 Usa este endpoint después de iniciar sesión para crear un nuevo descubrimiento.

EndFragment

\n","urlObject":{"path":["asterium"],"host":[""],"query":[],"variable":[]}},"response":[],"_postman_id":"0315e45f-aa47-412a-824d-c0bc84bd47ff"},{"name":"Actualizar descubrimiento","id":"87ac3829-ad62-4e6c-b11f-a7cac1167b1b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PUT","header":[{"key":"Authorization","value":"Bearer ","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"title\": \"Descubrimiento de exoplanetas raras\",\r\n \"slug\": \"exoplaneta-007\",\r\n \"content_md\": \"Se encontró nuevos exoplanetas 🌍\",\r\n \"status\": \"draft\"\r\n}","options":{"raw":{"language":"json"}}},"url":"/asterium/","description":"

StartFragment

🌌 Actualizar descubrimiento

Modifica los campos de un descubrimiento existente.

Solo el autor o un administrador pueden hacerlo.

Método: PUT
URL: /asterium/:id

🔹 Respuesta esperada (200 OK)

{\n    \"id\": 12,\n    \"author_id\": 15,\n    \"title\": \"Descubrimiento de exoplanetas raras\",\n    \"slug\": \"exoplaneta-007\",\n    \"excerpt\": null,\n    \"content_md\": \"Se encontró nuevos exoplanetas 🌍\",\n    \"status\": \"draft\",\n    \"published_at\": null,\n    \"like_count\": 0,\n    \"created_at\": \"2025-10-07T15:03:01.000Z\",\n    \"updated_at\": \"2025-10-07T15:15:27.091Z\"\n}\n\n

🔸 Errores posibles

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Código	Causa	Descripción
403	Forbidden	No tiene permisos para editar.
404	Not Found	El descubrimiento no existe.

🧠 Notas

Requiere autenticación.
\n
Solo el creador o un admin puede editar.
\n

🌠 Ejemplo visual

📍 Usa este endpoint para actualizar información en la vista de edición.

EndFragment

\n","urlObject":{"path":["asterium",""],"host":[""],"query":[],"variable":[]}},"response":[],"_postman_id":"87ac3829-ad62-4e6c-b11f-a7cac1167b1b"},{"name":"Eliminar descubrimiento","id":"89ee94b1-d2d8-4fa2-9f2f-882fee702d30","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"DELETE","header":[{"key":"Authorization","value":"Bearer ","type":"text"}],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"/asterium/","description":"

StartFragment

🌌 Eliminar descubrimiento

Elimina definitivamente un descubrimiento del sistema.

Método: DELETE
URL: /asterium/:id

🔹 Respuesta esperada (200 OK)

{\n  \"message\": \"Descubrimiento eliminado correctamente.\"\n}\n\n

🔸 Errores posibles

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Código	Causa	Descripción
404	Not Found	No se encontró el descubrimiento.
403	Forbidden	El usuario no tiene permisos.

🧠 Notas

Requiere autenticación.
\n
Solo el autor o el admin puede eliminarlo.
\n

🌠 Ejemplo visual

📍 Usa este endpoint para eliminar un registro desde el panel de administración.

EndFragment

\n","urlObject":{"path":["asterium",""],"host":[""],"query":[],"variable":[]}},"response":[],"_postman_id":"89ee94b1-d2d8-4fa2-9f2f-882fee702d30"},{"name":"Promover usuario o administrador","id":"557ee19e-d561-4d2f-84d0-01aaf814257d","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PUT","header":[{"key":"Authorization","value":"Bearer ","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"email\":\"mattwos@test.com\",\r\n \"password\": \"mattwos123\"\r\n}","options":{"raw":{"language":"json"}}},"url":"/auth/promote/","description":"

🛡️ Promover usuario a administrador

Permite que un usuario con rol de administrador cambie el rol de otro usuario a \"admin\".

🔹 Método:
PUT

🔹 URL:
/auth/promote/:id

🔸 Requiere autenticación (Auth: Bearer Token de un admin)

🔹 Ejemplo de solicitud:
PUT /auth/promote/3

🔹 Encabezados (Headers)
Key | Value
------------------ | --------------------------------------
Content-Type | application/json
Authorization | Bearer

🔹 Cuerpo (Body)
No requiere cuerpo en la solicitud (vacío).

🔹 Respuesta esperada (200 OK)
{
\"message\": \"Usuario promovido a admin\",
\"id\": 1
}

🔹 Errores posibles
Código | Causa | Descripción
-------|--------|-------------
401 | Unauthorized | Token inválido o ausente.
403 | Forbidden | El usuario autenticado no es admin.
404 | Not Found | Usuario con ese ID no encontrado.
500 | Server Error | Error interno del servidor.

🌠 Ejemplo visual
📍 Usa esta ruta para asignar privilegios de administrador a otro usuario dentro del sistema.

\n","urlObject":{"path":["auth","promote",""],"host":[""],"query":[{"disabled":true,"key":"","value":null}],"variable":[]}},"response":[],"_postman_id":"557ee19e-d561-4d2f-84d0-01aaf814257d"},{"name":"Listar descubrimientos eliminados (solo admins)","id":"f4fdb3d5-75b5-4b69-9c39-229d4a8db300","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":false},"method":"GET","header":[],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"http://localhost:4000/admin/deleted","description":"

StartFragment

Descripción:

Devuelve todos los descubrimientos que fueron marcados como eliminados mediante soft delete.

Incluye los campos id, title, status y deleted_at.

Autenticación: JWT válido (admin).

💡 Ejemplo de petición:

GET http://localhost:4000/admin/deleted\nAuthorization: Bearer <tu_token_admin>\n\n

Ejemplo de respuesta (200 OK):

[\n  {\n    \"id\": 11,\n    \"title\": \"Nebulosa Aeterna\",\n    \"status\": \"published\",\n    \"deleted_at\": \"2025-10-16T03:03:00.000Z\"\n  },\n  {\n    \"id\": 12,\n    \"title\": \"Exoplaneta N-42\",\n    \"status\": \"draft\",\n    \"deleted_at\": \"2025-10-16T04:12:00.000Z\"\n  }\n]\n\n

\n

Si no hay registros eliminados, se devuelve un arreglo vacío [].

EndFragment

\n","urlObject":{"protocol":"http","port":"4000","path":["admin","deleted"],"host":["localhost"],"query":[],"variable":[]}},"response":[],"_postman_id":"f4fdb3d5-75b5-4b69-9c39-229d4a8db300"},{"name":"Ver un descubrimiento eliminado por ID","id":"e2e98a0a-47fc-4e32-84db-11369fd06bfa","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":false},"method":"GET","header":[],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"http://localhost:4000/admin/deleted/11","description":"

StartFragment

Descripción:

Permite consultar el detalle de un descubrimiento que fue eliminado,

útil para verificar antes de restaurar.

Autenticación: JWT válido (admin).

💡 Ejemplo de petición:

GET http://localhost:4000/admin/deleted/11\nAuthorization: Bearer <tu_token_admin>\n\n

Ejemplo de respuesta (200 OK):

{\n  \"id\": 11,\n  \"title\": \"Nebulosa Aeterna\",\n  \"excerpt\": \"Una vasta nube interestelar que brilla con tonos violáceos.\",\n  \"status\": \"published\",\n  \"deleted_at\": \"2025-10-16T03:03:00.000Z\"\n}\n\n

\n

Si el ID no existe o el descubrimiento no está eliminado, se devuelve:
404 Not Found con el mensaje \"Descubrimiento no encontrado o no eliminado.\"

EndFragment

\n","urlObject":{"protocol":"http","port":"4000","path":["admin","deleted","11"],"host":["localhost"],"query":[],"variable":[]}},"response":[],"_postman_id":"e2e98a0a-47fc-4e32-84db-11369fd06bfa"}],"event":[{"listen":"prerequest","script":{"id":"06bab6b0-4bec-489d-9ff6-69137486c05a","type":"text/javascript","packages":{},"requests":{},"exec":[""]}},{"listen":"test","script":{"id":"2ec40939-bab4-471d-9428-2af42d4b1cb5","type":"text/javascript","packages":{},"requests":{},"exec":[""]}}],"variable":[{"key":"base_url","value":""},{"key":"token","value":""},{"key":"user_id","value":""},{"key":"asterium_id","value":""}]}

📘 Registrar usuario

🔸 Body (JSON)

🔹 Respuesta esperada (201 Created)

🔸 Errores posibles

🧠 Notas

🌠 Ejemplo visual

🌙 Iniciar sesión (Login)

🔸 Body (JSON)

🔹 Respuesta esperada (200 OK)

🔸 Errores posibles

🧠 Notas

🌠 Ejemplo visual

🌌 Listar descubrimientos

🔹 Ejemplo de respuesta (200 OK)

🔸 Errores posibles

🧠 Notas

🌠 Ejemplo visual