Zmeny a verzie API

Developer API má hlavnú verziu v adrese (/api/v1) a dátumovú verziu API, ktorá určuje presnú zmluvu. Táto stránka ukazuje, kde nájsť obe, ako stiahnuť strojovo čitateľnú špecifikáciu a aké vydania vyšli. Anglická verzia: Changelog and versioning.

Kde prečítať verziu API

Dátumová verzia je na štyroch miestach: v hlavičke X-Dakoty-Api-Version každej odpovede API, v poli data.api_version vo volaní GET /me, v poli api_version každej obálky webhooku a v info.version špecifikácie OpenAPI. Aktuálna verzia je 2026-10-01. Zaznamenávajte ju k požiadavkám, aby ste pri hľadaní chyby vedeli, podľa akej zmluvy prišiel konkrétny obsah.

curl -sSI https://api.dakoty.com/api/v1/public/me \
  -H "Authorization: Bearer $DAKOTY_API_KEY" | grep -i x-dakoty-api-version

Pište klientov tolerantne

Berte zmluvu ako otvorenú pre doplnenia. Ignorujte polia odpovedí a webhookov, ktoré nepoznáte, nespoliehajte sa na poradie kľúčov ani položiek zoznamu, ak ho nesľubuje parameter sort, a udalosti, ktoré ste neodoberali, spracujte bez zlyhania. Opierajte sa len o zdokumentované polia, stabilné hodnoty code chýb a stavy HTTP. Tím Dakoty zatiaľ nezverejnil formálnu dobu na vyradenie funkcií, preto pred plánovaním okolo odstránenia skontrolujte túto stránku.

Stiahnutie špecifikácie OpenAPI

Špecifikácia je vo formáte OpenAPI 3.1 a je zdrojom pravdy pre koncové body, schémy, oprávnenia a udalosti webhookov. Je verejná, nepotrebuje kľúč a posiela otvorené hlavičky CORS, takže ju vedia načítať aj nástroje v prehliadači. Použite ju na generovanie klienta alebo import do nástroja, ako je Postman. Referencia API zobrazuje ten istý súbor naživo. Slovenské texty sú v poliach x-sk-*.

curl -sS -o public-v1.yaml https://api.dakoty.com/api/v1/openapi/public-v1.yaml
curl -sS -o public-v1.json https://api.dakoty.com/api/v1/openapi/public-v1.json

Čo prináša vydanie 2026-10-01

Je to prvé vydanie Developer API v1. Prináša toto:

• zdroje so zoznamom, detailom, vytvorením a úpravou tam, kde to dáva zmysel: firmy a kontakty, klienti, leady (vrátane archivácie a presunu), aktivity (vrátane dokončenia), úlohy, faktúry, rezervácie (vrátane zrušenia) a objednávky (zoznam),
• číselníky používateľov, zdrojov leadov, pipeline, dôvodov straty, typov aktivít, štítkov, vlastných polí, projektov, rezervačných služieb a personálu,
• stránkovanie kurzorom s created_after a updated_since, pozri Stránkovanie a synchronizácia,
• Idempotency-Key pri POST požiadavkách, pozri Idempotencia,
• webhooky podpísané podľa Standard Webhooks a rozvrh deviatich pokusov, pozri Webhooky,
• REST hooky pre Make, Zapier a n8n, pozri REST hooky,
• oprávnenia podľa zdroja a pravidlo, že GET /orders je dostupný len kľúčom v1, pozri Overenie a oprávnenia.

Ako sledovať zmeny

Porovnajte info.version stiahnutej špecifikácie s verziou, podľa ktorej ste integráciu postavili, a keď sa líši, porovnajte oba súbory. Nové vydania pridáme na túto stránku s dátumom. Otázky a hlásenia chýb k API smerujte na podporu Dakoty.