Обзор публикации API
Путь API от идеи и контракта до Developer Portal и Production.
API Publishing
Публикация API — это управляемый процесс, а не только создание записи в WSO2 Publisher. API должен иметь владельца, согласованный контракт, выбранный integration flow, настроенную безопасность, проверенный backend и план сопровождения.
Результат процесса
- API или API Product опубликован в Developer Portal;
- OpenAPI отражает фактический runtime-контракт;
- определены scopes, subscriptions и rate limits;
- настроены обязательные platform policies;
- direct, async или orchestrated route проверен end-to-end;
- версия может быть воспроизводимо перенесена между окружениями;
- назначены API Owner и support owner.
Created не означает Published
API в статусе CREATED доступен для доработки, но ещё не является готовым продуктом для Consumer. Публикация выполняется только после design, security и runtime-проверок.
Кто участвует
| Роль | Ответственность |
|---|---|
| API Owner | Ценность, аудитория, scope и lifecycle API |
| Analyst | Контракт, сценарии, ошибки и acceptance criteria |
| API Developer | OpenAPI, WSO2 configuration и тестирование |
| Integration Developer | Router, topics, flow и adapter contract |
| Security | AuthN/AuthZ, scopes, TLS и sensitive data review |
| Platform/DevOps | Delivery, environment configuration и observability |