El registro publicado de las APIs de Nebula. Cada API que se construye entra aqui con su ficha: que servicio la expone, por que endpoint se llega, donde esta su documentacion, en que version del contrato va y como se consulta su api-docs en Swagger.
Una API sin fila en este registro no esta publicada: quien la necesita tiene que preguntarle a quien la escribio o abrir el repositorio. Esta seccion elimina ese paso.
No reemplaza al
api-docs. El contrato vigente siempre es el que publica el servicio. Esta seccion dice cual es, como se llega y que resuelve; el detalle campo por campo lo entrega Swagger.
Son puertas de acceso, no contenedores. Cada una lista los accesos a las APIs de su linea; la documentacion de cada API vive en la carpeta de SU SERVICIO, no dentro de la entrada.
| # | Entrada | A que da acceso |
|---|---|---|
| 1 | API Backend | APIs REST expuestas por los microservicios nebula-* a traves del Gateway Simappe |
| 2 | API Frontend | APIs y contratos consumidos o expuestos desde el frontend Nebula |
| API | Linea |
|---|---|
| Permisos de Operacion y Asignacion Rol-Permiso | Backend · nebula-masters |
| Grilla Declarativa de Listados | Frontend · nebula-ui-kit |
| Campo de Autocompletado contra el Servidor | Frontend · nebula-ui-kit |
Una API entra cuando esta mergeada a develop y desplegada en DEV. Antes de eso no se publica: el registro afirma lo que existe y responde, no lo que esta en camino.
Donde va cada cosa:
| Artefacto | Ubicacion |
|---|---|
| La documentacion de una API | Su propia pagina, API_<SERVICIO>_<DOMINIO>.md, colgada de esta seccion |
| El acceso a esa API | Una fila en la entrada que le corresponde, api-backend o api-frontend |
Cada API se documenta COMPLETA en su pagina, con su token, su acceso y sus contratos, aunque eso se repita entre APIs. Quien abre una API no tiene que ir a buscar a otra parte lo que le falta. Las entradas solo crecen en filas.
Cada fila del registro trae, sin excepcion:
| Campo | Que dice |
|---|---|
| Servicio | Microservicio que expone la API y su context-path |
| Endpoint | Ruta base de la API |
| Documentacion | Enlace a la pagina de detalle de la API en esta wiki |
| Version | Version del contrato expuesto (v1, v2, ...) |
| api-docs | URL del contrato OpenAPI del servicio en DEV |
Todo api-docs y todo swagger-ui exige Bearer Token JWT. El Gateway rechaza cualquier ruta que no este marcada como publica. El procedimiento completo — login, extraccion del token, import en Postman, visualizacion — esta en Consulta de Documentacion OpenAPI.
| Version | Fecha | Autor | Descripcion |
|---|---|---|---|
| 1.4.0 | 2026-09-14 | Carlos Torres | Se publica el campo de autocompletado contra el servidor, segunda API de la linea frontend |
| 1.3.0 | 2026-09-02 | Carlos Torres | Se publica la grilla declarativa de listados, primera API de la linea frontend |
| 1.2.0 | 2026-09-01 | Carlos Torres | Cada API es una pagina propia y autocontenida: se retira el agrupamiento por servicio y la especificacion se repite en cada una |
| 1.1.0 | 2026-09-01 | Carlos Torres | Las dos entradas dejan de contener documentacion: cada API pasa a la carpeta de su servicio y las entradas solo dan el acceso |
| 1.0.0 | 2026-09-01 | Carlos Torres | Creacion de la seccion Nebula APIs con las entradas API Backend y API Frontend |