Začíname s API Dakoty

Developer API v1 je JSON REST API na prepojenie Dakoty s Make, Zapierom, n8n, AI asistentmi a vlastným kódom. Táto stránka vás dovedie k prvému fungujúcemu volaniu zhruba za päť minút. Zoznam všetkých koncových bodov je v referencii API (je v angličtine). Anglická verzia tohto návodu je na stránke Getting started.

Adresa API a základné pravidlá

Všetky požiadavky idú na https://api.dakoty.com/api/v1/public cez HTTPS. Jeden záznam príde ako {"data": {...}}, zoznam ako {"data": [...], "next_cursor": ..., "has_more": ...}. Každá odpoveď má hlavičky X-Dakoty-Api-Version, X-RateLimit-Limit, X-RateLimit-Remaining a X-RateLimit-Reset. Telo požiadavky je JSON s hlavičkou Content-Type: application/json. Organizáciu určuje samotný kľúč, takže v adrese nie je žiadny identifikátor organizácie.

Ako vytvoriť API kľúč

V Dakoty otvorte Nastavenia organizácie, záložku Integrácie a časť API kľúče a založte nový kľúč. Vyberte predvoľbu pre Make, Zapier a n8n alebo oprávnenia zvoľte sami a skopírujte kľúč, ktorý začína dk_live_. Dakoty ho ukáže iba raz, preto ho uložte do správcu tajomstiev alebo do premennej prostredia. Postup krok za krokom je v článku Ako vytvoriť a spravovať API kľúč, oprávnenia vysvetľuje stránka Overenie a oprávnenia.

Overenie kľúča cez GET /me

Volanie GET /me nevyžaduje žiadne oprávnenie, zavolať ho môže každý platný kľúč. Vráti organizáciu, oprávnenia a platnosť kľúča, verziu API a vaše limity.

export DAKOTY_API_KEY="dk_live_..."
curl -sS https://api.dakoty.com/api/v1/public/me \
  -H "Authorization: Bearer $DAKOTY_API_KEY"

Ukážka odpovede GET /me

Úspešné volanie vráti stav 200. Chýbajúci, nesprávny, vypršaný alebo zrušený kľúč vráti 401 s kódom chyby UNAUTHORIZED.

{
  "data": {
    "organization": { "id": "0b5f7c1e-3c52-4d0e-9a53-6f0c1f6a2b11", "name": "Acme s.r.o.", "slug": "acme" },
    "token": {
      "id": "6d1c1a58-7a0e-4c0b-8b0e-2f3b9c7d5e42",
      "name": "Make - Jana",
      "scopes": ["leads:read", "leads:write", "webhooks:manage"],
      "expires_at": "2027-10-11T00:00:00Z"
    },
    "api_version": "2026-10-01",
    "limits": { "requests_per_minute": 120, "org_requests_per_minute": 600 }
  }
}

Prvé volanie z Node.js

Potrebujete Node.js 18 alebo novší. Uložte ukážku ako me.mjs (prípona .mjs zapína await na najvyššej úrovni) a spustite node me.mjs.

const BASE = "https://api.dakoty.com/api/v1/public";

const res = await fetch(`${BASE}/me`, {
  headers: { Authorization: `Bearer ${process.env.DAKOTY_API_KEY}` },
});
const body = await res.json();
if (!res.ok) throw new Error(`${res.status} ${body.error.code}: ${body.error.message}`);

console.log(body.data.organization.name, body.data.token.scopes);

Prvé volanie z Pythonu

Ukážka používa balík requests. Raz spustite pip install requests a potom skript.

import os
import requests

BASE = "https://api.dakoty.com/api/v1/public"
headers = {"Authorization": f"Bearer {os.environ['DAKOTY_API_KEY']}"}

r = requests.get(f"{BASE}/me", headers=headers, timeout=30)
r.raise_for_status()
me = r.json()["data"]
print(me["organization"]["name"], me["token"]["scopes"])

Čítanie a vytvorenie leadu

Zoznam leadov vyžaduje oprávnenie leads:read, vytvorenie leadu leads:write. Vnorené objekty company a contact sa spárujú s existujúcimi záznamami alebo sa vytvoria. Pošlite Idempotency-Key, aby opakovanie požiadavky nevytvorilo druhý lead (pozri Idempotencia).

curl -sS "https://api.dakoty.com/api/v1/public/leads?limit=5" \
  -H "Authorization: Bearer $DAKOTY_API_KEY"

curl -sS -X POST https://api.dakoty.com/api/v1/public/leads \
  -H "Authorization: Bearer $DAKOTY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: web-form-2026-10-11-0001" \
  -d '{"name":"Website enquiry","value":1200,"dedupe":"company",
       "company":{"name":"Acme s.r.o.","registration_id":"12345678"},
       "contact":{"name":"Jana Novakova","email":"jana@acme.example"}}'

Kam pokračovať ďalej

Prečítajte si Overenie a oprávnenia, aby mal kľúč iba prístup, ktorý potrebuje, Stránkovanie a synchronizáciu na čítanie veľkých zoznamov a Chyby a limity na ošetrenie zlyhaní. Ak chcete dostávať udalosti namiesto pravidelného dopytovania, pokračujte stránkami Webhooky a Overenie podpisu.