Rychlý start

Od přihlášení k první odpovědi

Osobní token vytvoříš v účtu, celý ho uvidíš právě jednou a potom ho ověříš bezpečným serverovým požadavkem.

1. Vytvoř token

Přihlas se a otevři Moje VolnéKurty → API & MCP. Zvol název, platnost a nejmenší potřebná oprávnění. Osobní oprávnění „Moje oblíbené“ není zaškrtnuté automaticky.

Spravovat tokeny

2. Ulož tajemství

Po vydání nebo obnově se zobrazí celý token. Zkopíruj ho rovnou do zabezpečeného úložiště klienta; po zavření dialogu ho VolnéKurty neumí znovu ukázat.

Token je heslo

Nedávej ho do URL, promptu, screenshotu, repozitáře, logu, analytiky ani veřejného JavaScriptu. V příkladech vždy zůstává placeholder.

3. Ověř REST

curl https://volnekurty.cz/api/v1/me \
  -H 'Authorization: Bearer <OSOBNI_API_TOKEN>'

Úspěšná odpověď vrátí scopes, datum expirace a společnou denní kvótu. Kontrola kvótu nečerpá, ale podléhá krátkodobému limitu.

4. Nebo připoj MCP

Do klienta vlož endpoint https://volnekurty.cz/api/mcp a hlavičku Authorization: Bearer <OSOBNI_API_TOKEN>. Token nesmí být součást URL ani argumentu toolu.

MCP návod a stav klientů

5. Odvolej nepoužívaný token

Každému klientovi dej vlastní token. Při ztrátě nebo ukončení integrace ho v účtu odvolej; další požadavek skončí 401.