OpenAPI 3.1 · Swagger UI

Contrato REST presentable y auditable

Abhackus publica un contrato OpenAPI para alinear desarrollo, QA, operación y colaboración externa con una única fuente de verdad.

Didáctica

Cada endpoint está agrupado por dominio funcional para facilitar onboarding de nuevos equipos.

Objetividad

OpenAPI es una especificación estándar; reduce ambigüedad entre backend, frontend y QA.

Colaboración

Con Swagger UI puedes probar rutas y validar payloads antes de abrir merge requests.

Auth y Sesiones

  • POST /api/auth/login
  • POST /api/auth/refresh
  • POST /api/auth/logout
  • POST /api/auth/logout-all
  • GET /api/auth/sessions
  • POST /api/auth/change-password
  • POST /api/auth/password-recovery
  • POST /api/auth/reset-password

Usuarios y Accesibilidad

  • POST /api/bootstrap/first-superadmin
  • GET|POST /api/users
  • PUT /api/users/{id}
  • GET /api/users/me
  • GET|PUT /api/users/accessibility
  • POST /api/users/usage/ping
  • GET /api/users/usage-status

Salud y Observabilidad

  • GET /
  • GET /api/health
  • GET /api/metrics (Prometheus)

Contabilidad

  • GET|POST /api/accounting/entries
  • GET /api/accounting/entries/{id}/detail
  • POST /api/accounting/entries/{id}/approve
  • POST /api/accounting/entries/{id}/reject
  • POST /api/accounting/entries/{id}/attachments
  • GET /api/accounting/entries/{id}/attachments/{attachment_id}
  • GET /api/accounting/pending-entries
  • GET /api/accounting/approval-audit
  • GET /api/accounting/status
  • GET /api/accounting/my-entries
  • GET /api/accounting/my-status
  • POST /api/accounting/quota-change-request
  • GET|POST /api/accounting/projects

Proyecto, Reportes y Soporte

  • GET|PUT /api/project/settings
  • GET /api/project/settings/public
  • GET|POST /api/project/telegram-targets
  • PUT|DELETE /api/project/telegram-targets/{id}
  • GET /api/reports/club.html
  • GET /api/reports/club.pdf
  • GET /api/reports/me.html
  • GET /api/reports/me.pdf
  • GET /api/reports/monthly.ods
  • POST /api/reports/club/telegram
  • POST /api/support/contact-admins
  • POST /api/support/notify-community-change (admin/superadmin)
  • GET /api/notifications/my
  • POST /api/notifications/{id}/read
  • POST /api/notifications/{id}/ack
  • POST /api/notifications/admin/send (admin/superadmin)
  • GET /api/notifications/admin/history (admin/superadmin)
  • GET /api/security/gpg-public-key (miembro/admin/superadmin)