---
title: Futrou API
description: Automatizujte Futrou Cloud pomocí veřejného REST API v2.
---

## API endpoint

Futrou REST API je dostupné na adrese:

```text
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](https://app.futrou.com/) a posílejte jej jako bearer token:

```bash
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](https://api.futrou.com/) nebo ve [specifikaci OpenAPI v2](https://api.futrou.com/v2/openapi.json).