Futrou API

API endpoint

Futrou REST API je dostupné na adrese:

https://api.futrou.com/v2

Používá HTTPS a JSON. U požadavků s tělem posílejte hlavičku Content-Type: application/json.

Autentizace API tokenem

Pro automatizaci vytvořte dlouhodobý API token ve Futrou Console a posílejte jej jako bearer token:

curl https://api.futrou.com/v2/... \
  -H "Authorization: Bearer $FUTROU_API_TOKEN" \
  -H "Accept: application/json"

Tokeny ukládejte do proměnných prostředí nebo CI secret store, nikdy do repozitáře. Autentizace session cookie je určena pro interaktivní prohlížečové použití; pro automatizaci doporučujeme bearer token.

Stránkování, limity a chyby

List endpointy přijímají parametry page, limit, sort a direction. Metadata stránkování vracejí hlavičky X-Total-Pages, X-Total-Items a X-Page.

API má globální limit 100 požadavků za sekundu. Odpověď 429 Too Many Requests obsahuje Retry-After; před dalším pokusem vyčkejte uvedený čas.

Úplná reference

Všechny endpointy, schémata požadavků a odpovědí najdete v interaktivní API referenci nebo ve specifikaci OpenAPI v2.