REST API

Bazowy adres: https://ai.ydq.pl/api/v1. Pełna specyfikacja: OpenAPI 3.1.

Uwierzytelnienie

Nagłówek Authorization: Bearer <token>. Token tworzysz w sekcji „Co udostępniasz AI?”, z wybranymi zakresami i skrzynkami. Tokeny MCP nie działają na tym zasobie, a tokeny REST nie działają na MCP. Konektory ChatGPT i Claude łączą się przez OAuth, bez wklejania tokenu.

Wysyłka

1. POST /drafts tworzy szkic.
2. GET /drafts/{id}/preview zwraca treść i content_hash.
3. POST /drafts/{id}/send-request z Idempotency-Key tworzy wniosek i zwraca approval_url.
4. Właściciel zatwierdza wiadomość w panelu. API nie ma takiej operacji.
5. GET /operations/{id} pokazuje stan.

Błędy

Format: {"error":{"code","message","retryable","retry_after","request_id"}}. Statusy: 400, 401, 403, 404, 409, 422, 429, 503.