APIAPI
Carte de référence Production API
Orientation humaine ; la référence générée et OpenAPI restent l’autorité machine exacte.
Maturité API / MCP
La documentation est publique, mais la disponibilité API/MCP dépend du manifeste actif et des droits du compte. Foundation ou experimental ne garantit pas la stabilité.
| Méthode | Endpoint | Autorité | Objectif |
|---|---|---|---|
| GET | /api/v1/product/manifest | read | Vérité et maturité du produit |
| GET | /api/v1/openapi | read | Contrat API lisible par machine |
| GET | /api/v1/production/capabilities | read | Découvrir les capacités de production disponibles |
| GET | /api/v1/production/verticals | read | Lister les recettes de production |
| POST | /api/v1/production/plans | plan | Compiler un plan de production sans dépense |
| POST | /api/v1/production/plans/:planId/preflight | read | Valider la préparation avant exécution |
| POST | /api/v1/production/plans/:planId/storyboard/apply | mutate | Appliquer un Storyboard approuvé |
| POST | /api/v1/production/plans/:planId/steps/:stepId/execute | spend | Exécuter une étape confirmée du plan |
| POST | /api/v1/production/plans/:planId/generate | spend | Démarrer une production durable confirmée |
| GET | /api/v1/production/jobs/:jobId | read | Lire le statut durable du job |
| GET | /api/v1/production/plans/:planId/ledger | read | Lire le ledger d’exécution |
Utilisez le contrat généré pour les champs exacts
Cette page explique l’intention. Schemas exacts : /api/v1/docs et /api/v1/openapi.
Traitez les erreurs comme un état
Gérez codes et statuts HTTP pour auth, forbidden, IDs invalides, idempotence, crédits, preflight, rate limit et infrastructure.
Retry des lectures avec discernement
Les erreurs de lecture potentiellement retryables sont séparées des mutations/dépenses qui ne doivent jamais être rejouées aveuglément.
Workspace · Project · Asset · Entity · Storyboard · Plan · JobGénéré ≠ Certifié