API Reference

Esta sección se genera automáticamente desde cli/data/openapi.json (5.8 MB) mediante el script scripts/generate_api_reference.py. Para regenerar:

Recursos principales

Lista completa de los 56 recursos auto-generados desde OpenAPI — cada uno disponible en https://docs.tecsas3.com/es/api-reference/{slug}.

Convenciones

  • Base URL: https://dev.tecsas3.com (configurable).
  • Auth: Authorization: Token <KEY> o Authorization: Bearer <JWT>.
  • Tenant headers: X-Tenant-Slug, X-Tenant-Org-ID, X-Plan-ID.
  • Content-Type: application/json excepto en uploads.
  • Pagination: ?page=N&page_size=M (default 20, max 100).
  • Filtering: query params como ?nivel_riesgo=rojo&fecha_inicio=....

Formato de respuesta

Éxito:
Error:

Versioning

La API usa versionado por path: /api/v1/, /api/v2/. El CLI detecta la versión por recurso (los recursos IA v2 usan /api/ia/v2/).
Para ver la lista completa de endpoints, ejecuta tecsas3 util schema (alias raíz: tecsas3 schema).