APIAPI
Mapa de referência da Production API
Orientação humana; referência gerada e OpenAPI continuam sendo a autoridade exata.
Maturidade API / MCP
A documentação é pública, mas a disponibilidade de API/MCP depende do manifesto vivo e do acesso da conta. Foundation ou experimental não significa estabilidade.
| Método | Endpoint | Autoridade | Objetivo |
|---|---|---|---|
| GET | /api/v1/product/manifest | read | Verdade e maturidade do produto |
| GET | /api/v1/openapi | read | Contrato API legível por máquina |
| GET | /api/v1/production/capabilities | read | Descobrir capacidades de produção disponíveis |
| GET | /api/v1/production/verticals | read | Listar receitas de produção |
| POST | /api/v1/production/plans | plan | Compilar um plano de produção sem gasto |
| POST | /api/v1/production/plans/:planId/preflight | read | Validar prontidão antes da execução |
| POST | /api/v1/production/plans/:planId/storyboard/apply | mutate | Aplicar um Storyboard aprovado |
| POST | /api/v1/production/plans/:planId/steps/:stepId/execute | spend | Executar uma etapa confirmada do plano |
| POST | /api/v1/production/plans/:planId/generate | spend | Iniciar produção durável confirmada |
| GET | /api/v1/production/jobs/:jobId | read | Consultar status durável do job |
| GET | /api/v1/production/plans/:planId/ledger | read | Consultar o ledger de execução |
Use o contrato gerado para campos exatos
Esta página explica intenção. Schemas exatos: /api/v1/docs e /api/v1/openapi.
Trate erros como estado
Processe códigos e HTTP status para autenticação, forbidden, IDs inválidos, idempotência, créditos, preflight, rate limit e infraestrutura.
Repita leituras com critério
Falhas de leitura potencialmente repetíveis são separadas de mutações e gastos, que nunca devem ser repetidos às cegas.
Workspace · Project · Asset · Entity · Storyboard · Plan · JobGerado ≠ Certificado