Preskočiť na obsah
Dakoty — PomocníkDakoty — PomocníkDakoty — Pomocník

Aplikácia Make

Overené k 17. októbra 2026

Aplikácia Dakoty pre Make je sada modulov postavená na Developer API v1. Obsahuje 13 okamžitých spúšťačov (Watch …), akcie a vyhľadávania pre leady, firmy, kontakty, aktivity, úlohy, faktúry a rezervácie a jeden univerzálny modul Make an API call. Aplikácia nie je samostatné API: každý modul volá endpoint, ktorý môžete volať aj z vlastného kódu. Referencia API je preto zdrojom pre to, čo moduly posielajú a čo dostávajú.

Krok za krokom nastavenie v Make a v Dakoty nájdete v článku Pomocníka Ako prepojiť Dakoty s Make.

Pripojenie a kľúč

Section titled “Pripojenie a kľúč”

Pripojenie v Make chce jedinú hodnotu, API kľúč, ktorý začína dk_live_. Make ho posiela ako Authorization: Bearer <kľúč> a overí ho cez GET /me. Platný kľúč zobrazí pri pripojení názov vašej organizácie; zlý alebo zrušený kľúč vráti 401.

Kľúč vytvorte v Dakoty v Integrácie → API kľúče a vyberte predvoľbu Make / Zapier / n8n – bežné použitie. Predvoľba pokrýva leady, firmy, kontakty, aktivity, úlohy, čítanie faktúr, rezervácií a objednávok a správu webhookov. Neobsahuje invoices:write ani bookings:write, preto Create an invoice, Create a booking a Cancel a booking vrátia 403, kým tieto oprávnenia nepridáte. Pravidlá oprávnení sú v návode Autentifikácia a scopes.

Spúšťače používajú REST hooky

Section titled “Spúšťače používajú REST hooky”

Keď scenár zapnete, modul spúšťača zaregistruje webhook cez POST /webhooks. Webhook sa volá Make - <udalosť>, napríklad Make - lead.created. Pri vypnutí scenára alebo odstránení spúšťača ho Make zmaže cez DELETE /webhooks/{id}. URL nikde nevkladáte ručne. Princíp popisuje návod REST hooky, doručovanie, podpisy a opakovanie fungujú ako v návode Webhooky.

Spúšťače potrebujú webhooks:manage a čítacie oprávnenie entity, ktorú sledujú, napríklad leads:read pre Watch new leads.

Akcie a vyhľadávania

Section titled “Akcie a vyhľadávania”

Každá akcia (napríklad Create a lead alebo Move a lead to a stage) urobí jednu požiadavku. Create a lead prijíma hlavičku Idempotency-Key, takže opakovaný beh scenára nevytvorí lead dvakrát; pozri Idempotencia.

Každé vyhľadávanie (napríklad Search leads) prechádza stránky zoznamového endpointu cez kurzor. Pole Limit určuje, koľko záznamov jeden beh vráti; predvolene je 10 a aplikácia nikdy nevyžiada viac ako 100 na stránku. Pravidlá sú v návode Stránkovanie a synchronizácia.

Rozbaľovacie zoznamy niektorých polí (vlastník, pipeline, typ aktivity, projekt) na pozadí volajú číselníkové endpointy. Tie potrebujú čítacie oprávnenie danej oblasti, napríklad users:read pre zoznam vlastníkov. Popis modulu uvádza dodatočné oprávnenia, ktoré potrebuje.

Make an API call

Section titled “Make an API call”

Modul Make an API call použite pre každý endpoint, pre ktorý zatiaľ nemá vlastný modul. Zadáte cestu za https://api.dakoty.com/api/v1/public, metódu, voliteľné hlavičky, query reťazec a telo. Hlavičku Authorization pridá modul sám, takže kľúč do požiadavky nevkladáte.

Cesta musí byť relatívna k API. Fungujú obe varianty /me aj me. Modul posiela požiadavky vždy na api.dakoty.com, takže kľúč sa k inej adrese nedostane.

Chyby a limity

Section titled “Chyby a limity”

Modul v Make zobrazí kód chyby a správu z API. Pravidlá opakovania, stavové kódy a hlavičky limitov sú v návode Chyby a limity.

Dostupnosť aplikácie Make

Section titled “Dostupnosť aplikácie Make”

Ak aplikáciu Dakoty v Make ešte nevidíte, rovnaké endpointy dosiahnete cez modul HTTP v Make. Článok Pomocníka Ako prepojiť Dakoty s Make ukazuje postup, ktorý začína kontrolou GET /me.

Ďalšie kroky a odkazy

Section titled “Ďalšie kroky a odkazy”