Developer API Dakoty

Overené k 17. októbra 2026

Developer API v1 je JSON REST API na prepojenie Dakoty s Make, Zapierom, n8n, AI asistentmi a vlastným kódom. Cez API môžete čítať a zapisovať firmy, kontakty, klientov, leady, aktivity, úlohy, faktúry a rezervácie, čítať produkty a objednávky e-shopu a odoberať udalosti cez webhooky. Táto stránka je mapa: vyberte si návod zo zoznamov na tejto stránke alebo skočte rovno na referenciu API. Anglická verzia: Dakoty Developer API.

Základy, ktoré potrebujete

• Adresa: https://api.dakoty.com/api/v1/public. Každá odpoveď je JSON; jeden záznam je v {"data": …}, zoznam v {"data": […], "next_cursor", "has_more"}.
• Overenie: API kľúč posielajte v hlavičke Authorization: Bearer dk_live_…. Každý kľúč má oprávnenia (scopes), napríklad leads:read alebo companies:write. Aplikácie, ktoré si človek pripojí k svojmu účtu (napríklad Zapier), používajú namiesto kľúča OAuth prístupový token. Pozrite Overenie a oprávnenia a OAuth prístupové tokeny.
• Prvé volanie: GET /me nepotrebuje žiadne oprávnenie a ukáže organizáciu, oprávnenia a limity kľúča. Návod Začíname vás ním prevedie asi za päť minút.
• Limity: predvolene 120 požiadaviek za minútu na kľúč a 600 na organizáciu (presné čísla vášho kľúča vráti GET /me). Odpovede nesú hlavičky X-RateLimit-* a spomalená požiadavka dostane 429 s Retry-After. Podrobnosti v návode Chyby a limity.
• Bezpečné opakovanie: k POST požiadavkám pridajte hlavičku Idempotency-Key, pozrite Idempotencia.
• Strojovo čitateľná špecifikácia: OpenAPI 3.1 ako YAML alebo JSON, bez kľúča. Každá operácia v referencii má ukážky v curl, JavaScripte/TypeScripte, PHP a Go.

Návody ku každej téme

Každý návod pokrýva jednu tému od začiatku do konca:

• Začíname: Vytvorte kľúč, zavolajte GET /me a urobte prvé čítanie a zápis.
• Overenie a oprávnenia: API kľúče, scopes a starší e-shopový kľúč.
• OAuth prístupové tokeny: Ako pripojené aplikácie volajú API v mene človeka.
• Stránkovanie a synchronizácia: limit, cursor, created_after a updated_since.
• Chyby a limity: Formát chýb, kódy, hlavičky limitov a slučka opakovania.
• Idempotencia: Opakovanie POST bez duplicít.
• Zmeny a verzie: Verzie API a čo sa zmenilo.

Webhooky a automatizácia

Dakoty vie posielať udalosti na váš server alebo do automatizačného nástroja:

• Webhooky: Udalosti, doručenie a rozvrh deviatich pokusov.
• Overenie podpisu webhooku: Podpisy Standard Webhooks v Node.js, Pythone a PHP.
• REST hooky: Prihlásenie cieľovej adresy cez POST /webhooks.
• Aplikácia pre Make: Ako aplikácia Dakoty pre Make používa API.
• Uzol pre n8n: Komunitný uzol a jeho spúšťač.

Zapier sa pripája cez OAuth prístupové tokeny a rovnaké REST hooky ako Make a n8n.

Interaktívna referencia API

Interaktívna referencia API sa vykresľuje zo živej špecifikácie OpenAPI, takže vždy zodpovedá nasadenému API. Texty popisov operácií sú v nej zatiaľ po anglicky.

Otázky a hlásenia chýb

Napíšte podpore Dakoty z aplikácie. Pridajte čas volania a code z tela chyby.