APIAPI
Карта Production API
Человеческая навигация; точная машинная authority — сгенерированный API Reference и OpenAPI.
Зрелость API / MCP
Документация публична, но доступность API/MCP определяется живым манифестом и правами аккаунта. Foundation/experimental не являются обещанием стабильности.
| Метод | Endpoint | Authority | Назначение |
|---|---|---|---|
| GET | /api/v1/product/manifest | read | Истина продукта и уровень зрелости |
| GET | /api/v1/openapi | read | Машиночитаемый контракт API |
| GET | /api/v1/production/capabilities | read | Обнаружить доступные production capabilities |
| GET | /api/v1/production/verticals | read | Получить список production recipes |
| POST | /api/v1/production/plans | plan | Собрать production plan без расходов |
| POST | /api/v1/production/plans/:planId/preflight | read | Проверить готовность до execution |
| POST | /api/v1/production/plans/:planId/storyboard/apply | mutate | Применить утверждённый Storyboard |
| POST | /api/v1/production/plans/:planId/steps/:stepId/execute | spend | Выполнить подтверждённый шаг plan |
| POST | /api/v1/production/plans/:planId/generate | spend | Запустить подтверждённую durable production |
| GET | /api/v1/production/jobs/:jobId | read | Прочитать durable job status |
| GET | /api/v1/production/plans/:planId/ledger | read | Прочитать execution ledger |
Точные поля — в сгенерированном контракте
Здесь объясняется смысл. Точные schemas: /api/v1/docs и /api/v1/openapi.
Ошибки — это состояние
Обрабатывайте machine codes и HTTP status для auth, forbidden, invalid id, missing idempotency, credits, preflight, rate limit и infra.
Read retry — осторожно
Потенциально retryable read отделены от mutate/spend, которые нельзя повторять вслепую.
Workspace · Project · Asset · Entity · Storyboard · Plan · JobСгенерировано ≠ Сертифицировано