Notion API: čo sa dá napojiť a kde sú limity

To číslo je tri

Notion API zvládne tri požiadavky za sekundu. Pri prekročení vráti chybu 429.

Znie to ako technický detail pre programátora. V skutočnosti to rozhoduje o tom, ako sa celá integrácia navrhne – a je to rozdiel medzi riešením, ktoré beží roky, a skriptom, ktorý zomrie pri prvom väčšom objeme.

Rekurzívne načítavanie blokov narazí na ten limit okamžite. Nie za mesiac, ale pri prvom spustení nad reálnymi dátami.

Dôsledok je jednoduchý: prenosy sa musia dávkovať a synchronizovať priebežne, nie jednorazovými dumpmi. Prvotné naplnenie databázy býva dávka, ktorá beží niekoľko hodín. To je v poriadku – robí sa raz. Čo v poriadku nie je, je pokúšať sa to spraviť za minútu.

Čo sa napája najčastejšie

CRM. Obchody a kontakty obojsmerne, aby tím videl stav bez prepínania nástrojov. Najčastejšia zákazka zo všetkých.

Fakturácia a účtovníctvo. Stav faktúr priamo pri projekte alebo klientovi. Jednosmerne, z účtovného systému do Notionu.

E-shop. Objednávky do projektovej alebo servisnej evidencie, stav reklamácie späť.

Formuláre a web. Dopyty rovno do databázy s priradením a notifikáciou. Najlacnejšia integrácia vôbec a často prvá, ktorú si firma objedná.

Štyri veci, ktoré odlišujú integráciu od skriptu

Integrácia nie je kód, ktorý raz zbehne. Je to služba, ktorá musí bežať roky, keď sa na ňu nikto nepozerá.

Ošetrenie chýb a opakovanie. Keď je druhá strana nedostupná, prenos sa nesmie stratiť. Zaradí sa a skúsi znova. Bez toho zistíte výpadok vtedy, keď sa niekto spýta, prečo neprišli objednávky.

Logovanie. Pri každom probléme sa musí dať dohľadať, čo prešlo, čo neprešlo a prečo. Bez logu je hľadanie chyby hádanie.

Mapovanie číselníkov. Toto je najzradnejšia časť. Spôsoby dopravy, platby, sadzby DPH, stavy objednávok – všetko sa musí namapovať na začiatku. Je to miesto, kde integrácie tichým spôsobom kazia dáta celé mesiace, kým si to niekto všimne.

Testovacia prevádzka na reálnych dátach. Nie na troch vymyslených záznamoch. Reálne dáta obsahujú výnimky, o ktorých nikto netuší.

Kedy priama integrácia a kedy Make alebo n8n

Oboje má miesto a predstierať opak by bolo nepoctivé.

Pri jednoduchom prepojení dvoch nástrojov s malým objemom je Make alebo n8n rýchlejší a lacnejší. Postavíte to za pár hodín a mesačne to stojí pár eur.

Priama integrácia sa oplatí pri väčších objemoch, zložitejších transformáciách a všade tam, kde záleží na spoľahlivosti. Má lepšie ošetrenie chýb a nižšie prevádzkové náklady pri veľa behoch.

Na konzultácii to povieme rovno – vrátane prípadu, keď vám stačí to lacnejšie riešenie.

Čo si pripraviť pred prvým hovorom

Zoznam systémov, ktoré používate. Odhad objemu – koľko záznamov denne alebo mesačne. A hodinu času s človekom, ktorý tie dáta dnes prenáša ručne.

Ten tretí bod je najdôležitejší. Vie o výnimkách, o ktorých netuší ani vedenie, a práve výnimky rozhodujú o tom, či bude integrácia jednoduchá alebo zložitá.