Mapa de referencia de Production API
Orientación humana de la superficie canónica. La referencia generada y OpenAPI siguen siendo la autoridad exacta de máquina.
La documentación pública se puede compartir, pero la disponibilidad de capacidades API y MCP la gobiernan el manifiesto vivo y el acceso de la cuenta. Foundation o experimental no implican estabilidad.
| Método | Endpoint | Autoridad | Propósito |
|---|---|---|---|
| GET | /api/v1/product/manifest | read | Verdad y madurez del producto |
| GET | /api/v1/openapi | read | Contrato API legible por máquina |
| GET | /api/v1/production/capabilities | read | Descubrir capacidades de producción disponibles |
| GET | /api/v1/production/verticals | read | Listar recetas de producción |
| POST | /api/v1/production/plans | plan | Compilar un plan de producción sin gasto |
| POST | /api/v1/production/plans/:planId/preflight | read | Validar preparación antes de ejecutar |
| POST | /api/v1/production/plans/:planId/storyboard/apply | mutate | Aplicar un Storyboard aprobado |
| POST | /api/v1/production/plans/:planId/steps/:stepId/execute | spend | Ejecutar un paso confirmado del plan |
| POST | /api/v1/production/plans/:planId/generate | spend | Iniciar producción durable confirmada |
| GET | /api/v1/production/jobs/:jobId | read | Consultar el estado durable del job |
| GET | /api/v1/production/plans/:planId/ledger | read | Consultar el ledger de ejecución |
Usa el contrato generado para los campos exactos
Esta página explica intención y autoridad. Para schemas exactos y operaciones publicadas usa /api/v1/docs y /api/v1/openapi.
Trata los errores como estado, no como prosa
Maneja códigos de error y estados HTTP: autenticación, acceso prohibido, projectId inválido, idempotencia ausente, créditos insuficientes, blockers de preflight, rate limit y fallos de infraestructura.
Reintenta lecturas con criterio
El transporte distingue fallos de lectura potencialmente reintentables de operaciones que nunca deben repetirse a ciegas.