API Reference¶

Flawbusters предоставляет два уровня API:

Internal API¶

Используется фронтендом Flawbusters. Не документируется публично — интерфейс может меняться без предупреждения. Для интеграций используйте External Partner API.

External Partner API¶

Публичный API для LMS-интеграций:

Аутентификация: OAuth 2.0 Authorization Code + PKCE (линковка пользователей) + HMAC-SHA256 (server-to-server).
Формат: REST, JSON.
Base URL: https://flawbusters.com/api/v1

Обзор и примеры кода — в Integrations → External Partner API.

OpenAPI-спецификация¶

Интерактивный Swagger UI — coming soon

В одном из ближайших релизов OpenAPI-спека будет встроена прямо в этот раздел через Redoc/Swagger UI. Пока — запросите актуальную версию на support@flawbusters.com.

Версионирование¶

API версионируется через префикс пути (/api/v1/). Breaking changes приводят к увеличению major-версии. Deprecated endpoints помечаются заголовком Deprecation с датой удаления минимум за 6 месяцев.

Rate limits¶

Тип запроса	Лимит
OAuth token exchange	10 req/min на `client_id`
External API	60 req/min на `client_id`

Превышение — 429 Too Many Requests с Retry-After.