Ako vytvoriť a spravovať API kľúč

Vyžaduje oprávnenieSpravovať - Integrácie

Čo dosiahnete: API kľúč pre Make, Zapier alebo n8n

API kľúč je vstupenka, s ktorou sa Make, Zapier, n8n alebo váš program preukážu, že smú pracovať s dátami vašej firmy. Vyrobíte ho asi za minútu a dostanete reťazec, ktorý začína dk_live_. Dakoty vám ho ukáže iba raz.

Kto môže spravovať API kľúče

Kľúče spravuje vlastník organizácie a používateľ s oprávnením Spravovať - Integrácie. Kľúč dostane len tie oprávnenia, ktoré mu pri vytváraní vyberiete, nie všetky vaše.

Ako vytvoriť API kľúč – krok za krokom

Vpravo hore kliknite na svoje meno, vyberte Nastavenia organizácie a záložku Integrácie.
Prepnite na časť API kľúče.
Kliknite na Nový API kľúč. Otvorí sa okno Nový API kľúč.
Do poľa Názov napíšte, kto ho bude používať, napríklad Make – Jana.
Do poľa Poznámka môžete doplniť, na čo kľúč slúži.
V časti Oprávnenia vyberte jednu z troch možností.
V poli Platnosť nechajte 1 rok alebo vyberte Bez obmedzenia, 30 dní, 90 dní či Vlastný dátum (potom vyplňte Platí do).
Kliknite na Vytvoriť kľúč.
Pod nadpisom Tento kľúč uvidíte len teraz kliknite na ikonu kopírovania a kľúč vložte do Make, Zapieru alebo n8n.
Kliknite na Mám ho uložený.

Ktoré oprávnenia kľúču dať

Kľúč má vždy len také práva, aké mu dáte. Na výber sú tri možnosti:

Make / Zapier / n8n – bežné použitie: leady, firmy a kontakty, aktivity a úlohy čítať aj zapisovať; klientov, faktúry, rezervácie a objednávky len čítať; k tomu zapínanie webhookov. Pre začiatok stačí.
Len čítanie: všetky údaje len na čítanie, nič sa nedá meniť.
Vlastné…: tabuľka Oblasť so stĺpcami Čítať a Zapisovať. Zaškrtnite len to, čo scenár naozaj potrebuje.

Oblasť Webhooky má jediný prepínač: smie kľúč zapínať a vypínať webhooky (Make, Zapier a n8n si ich tak vedia zapnúť samy). Zbalená sekcia E-shop (pokročilé) patrí staršiemu e-shopovému API, bežne ju nepotrebujete.

Ako zmeniť alebo zrušiť API kľúč

V zozname kľúčov kliknite vpravo pri kľúči na tri bodky:

Premenovať – zmení názov a poznámku,
Zmeniť oprávnenia – platí okamžite a hodnota kľúča sa nezmení, v Make nič meniť nemusíte,
Zrušiť kľúč – potvrďte tlačidlom Zrušiť kľúč (alebo Nechať tak). Kľúč prestane fungovať hneď a scenáre dostanú chybu 401. Webhooky, ktoré si cez kľúč zapol Make alebo Zapier, sa zmažú tiež.

V zozname vidíte aj stĺpce Naposledy použitý (s názvom aplikácie, ak ju Dakoty pozná) a Platí do. Zrušené a vypršané kľúče ukáže prepínač Zobraziť aj neplatné.

Čo sa stane po vytvorení kľúča

Hotovo! Kľúč je v zozname s názvom, začiatkom (dk_live_…) a oprávneniami. Pri kľúči, ktorý ste 90 dní nepoužili, uvidíte štítok Nepoužitý 90+ dní, a týždeň pred koncom platnosti štítok Platí ešte n dní. Kľúč posielajte v hlavičke Authorization: Bearer dk_live_…. Organizácia môže mať predvolene najviac 20 kľúčov a každý smie poslať 120 požiadaviek za minútu (spolu 600 za minútu); limity sa môžu pre organizáciu líšiť.

Staršie e-shopové kľúče a objednávky

Novšie rozhranie Developer API vracia zoznam objednávok (GET /orders) iba novým kľúčom. Kľúč, ktorý má len oprávnenie čítať objednávky a ďalšie e-shopové oprávnenia (napríklad pre storefront), považujeme za starší a dostane chybu 403 LEGACY_KEY_NOT_ALLOWED. Riešenie: vytvorte nový kľúč s možnosťou Make / Zapier / n8n – bežné použitie. Starý kľúč pre e-shop môžete nechať, nič mu to nepokazí.

Časté problémy pri API kľúčoch

Kľúč som stratil. Dakoty si pamätá len jeho odtlačok, preto ho nevieme zobraziť znova. Vytvorte nový a starý zrušte.

Scenár dostáva 403 FORBIDDEN. Kľúču chýba oprávnenie na danú oblasť. Otvorte Zmeniť oprávnenia a pridajte ho.

Scenár dostáva 401. Kľúč bol zrušený alebo vypršal. Pozrite stav v zozname (Zobraziť aj neplatné).

Nemôžem vytvoriť ďalší kľúč. Dosiahli ste limit kľúčov (predvolene 20). Nepotrebné zrušte.

Nenašli ste svoj problém? Opýtajte sa Milana: vpravo hore kliknite na svoje meno a vyberte Podpora a pomoc. Milan je náš AI asistent a o Dakoty vie veľa; keď si nebude istý, odovzdá vás kolegom z podpory.