APIAPI
Production API Referenzkarte
Menschliche Orientierung; generierte Referenz und OpenAPI bleiben die exakte Maschinenautorität.
API-/MCP-Reife
Die Dokumentation ist öffentlich teilbar; Verfügbarkeit von API/MCP wird jedoch vom Live-Manifest und Kontozugriff bestimmt. Foundation oder experimental sind keine Stabilitätszusagen.
| Methode | Endpoint | Autorität | Zweck |
|---|---|---|---|
| GET | /api/v1/product/manifest | read | Produktwahrheit und Reifegrad |
| GET | /api/v1/openapi | read | Maschinenlesbarer API-Vertrag |
| GET | /api/v1/production/capabilities | read | Verfügbare Produktionsfähigkeiten entdecken |
| GET | /api/v1/production/verticals | read | Produktionsrezepte auflisten |
| POST | /api/v1/production/plans | plan | Einen Produktionsplan ohne Ausgaben erstellen |
| POST | /api/v1/production/plans/:planId/preflight | read | Bereitschaft vor der Ausführung prüfen |
| POST | /api/v1/production/plans/:planId/storyboard/apply | mutate | Ein freigegebenes Storyboard anwenden |
| POST | /api/v1/production/plans/:planId/steps/:stepId/execute | spend | Einen bestätigten Planschritt ausführen |
| POST | /api/v1/production/plans/:planId/generate | spend | Bestätigte dauerhafte Produktion starten |
| GET | /api/v1/production/jobs/:jobId | read | Dauerhaften Jobstatus lesen |
| GET | /api/v1/production/plans/:planId/ledger | read | Ausführungs-Ledger lesen |
Für Felddetails den generierten Vertrag verwenden
Diese Seite erklärt Bedeutung und Autorität. Exakte Schemas: /api/v1/docs und /api/v1/openapi.
Fehler als Zustand behandeln
Maschinenlesbare Codes und HTTP-Status für Auth, Forbidden, ungültige IDs, fehlende Idempotenz, Credits, Preflight, Rate Limit und Infrastruktur behandeln.
Leseoperationen vorsichtig wiederholen
Retrybare Leseprobleme sind von mutierenden oder bezahlten Operationen getrennt, die nie blind wiederholt werden dürfen.
Workspace · Project · Asset · Entity · Storyboard · Plan · JobGeneriert ≠ Zertifiziert