# POLITRAN API v1 — příkladové skripty

Spustitelné ukázky napojení na REST API. Všechny čtou konfiguraci z prostředí:

```
POLITRAN_API_BASE=https://politran.cz/api/v1
POLITRAN_API_TOKEN=…                               # token z Nastavení → API tokeny
POLITRAN_WEBHOOK_SECRET=whsec_…                    # jen pro přijímače webhooků
```

| Soubor | Co ukazuje |
|---|---|
| `curl.sh` | celý postup zadavatele přes curl: me → publishers → notice-fields → založení s idempotencí → kreativa → odeslání → polling `updated_since` |
| `php/politran_client.php` | minimální PHP klient (Guzzle není potřeba, jen cURL) + tentýž postup |
| `python/politran_client.py` | Python 3 (`requests`) klient + postup zadavatele |
| `node/politran-client.mjs` | Node 18+ (`fetch`) klient + postup vydavatele (seznam, detail, publish) |
| `webhook-receiver-php/index.php` | přijímač webhooků v PHP: ověření podpisu, dedup, okamžitá odpověď |
| `webhook-receiver-node/server.mjs` | přijímač webhooků v Node (raw body!) |

Samostatný sandbox neexistuje. Spouštějte jen s tokenem testovací organizace od SPIR a testovací oznámení posílejte jen testovacímu vydavateli SPIR; po testu je smažte (oznámení má od odeslání veřejnou stránku).