Make.com API Pagination Patterns Toolkit co v něm najdeš
Spustíš scénář. Vrátí 50 záznamů. Jenže v databázi jich je 4 000 a nikdo ti to nehlásí. Scénář proběhne bez chyby, data jsou neúplná a ty o tom nevíš. Tohle je klasická past API paginace v Make.com — a přesně proto jsem postavil API Pagination Patterns Toolkit.
💡 Pokud teprve začínáš s paginací v Make, přečti si nejdřív jak funguje Make.com pagination a načítání dat z API. Tento článek navazuje na to a jde hlouběji.
Proč paginace v Make bolí
Většina REST API nevrátí všechna data najednou. Rozdělí je na stránky a čeká, že si je postupně načteš. Bez správně nastaveného loopingu přijdeš o většinu dat — tiše, bez erroru.
Problém je, že každé API řeší paginaci trochu jinak. HubSpot používá cursor. GitHub vrací odkaz na další stránku v hlavičce. Jiné API pracuje s offsetem, další s číslem stránky. Pokaždé jiná logika, pokaždé jiná konfigurace v Make.
Každý scénář jsem řešil od nuly. Hledal dokumentaci, ladil podmínky, testoval hranice. Trávil jsem u toho hodiny — a pak jsem si uvědomil, že dělám totéž znova a znova. Tak jsem to celé zabalil do toolkitu.
4 typy paginace které toolkit řeší
Tohle jsou čtyři základní přístupy které REST API používají:
| Typ paginace | Jak funguje | Příklady API |
|---|---|---|
| Page-based | Posíláš parametr page=1, page=2… | Pipedrive, mnoho CRM |
| Offset-based | Posíláš offset=0, offset=50… | HubSpot (částečně), Airtable |
| Cursor-based | API vrátí token pro další stránku | HubSpot, Stripe, Shopify |
| Link header | URL další stránky je v HTTP hlavičce | GitHub, GitLab |
Každý z těchto typů má v toolkitu vlastní hotový pattern — včetně správně nastavené smyčky, podmínky ukončení a výstupní proměnné.
Co toolkit obsahuje
Toolkit je sada Make.com blueprintů připravených k okamžitému nasazení. Pro každý typ paginace dostaneš:
- Hotový blueprint — importuješ, nakopíruješ, přemapuješ URL a parametry
- Podmínku ukončení — smyčka se zastaví ve správný moment, neprojíždí zbytečně
- Výstupní proměnnou — všechna data agregovaná do jednoho pole pro další zpracování
- Komentáře přímo v scénáři — víš co měnit a proč
Nejpopulárnější patterny z toolkitu:
- Page-based loop — základní stránkování s automatickým ukončením po poslední stránce
- Offset incrementer — offset se zvyšuje o velikost stránky dokud API nevrátí méně záznamů než
limit - Cursor extractor — cursor se extrahuje z odpovědi a předává do další iterace
- Link header parser —
Linkhlavička se parsuje a vytahuje se URLnext
Jak toolkit použít
- Importuj blueprint odpovídající tvému typu API do Make.com
- Nakopíruj pattern do svého scénáře — nebo ho použij jako samostatný subflow
- Přemapuj URL a parametry podle dokumentace tvého API — ostatní logika zůstane
Nepotřebuješ rozumět každému detailu. Stačí vědět jaký typ paginace tvoje API používá — a to zjistíš z dokumentace nebo z první odpovědi API.
⚠️ Pokud pracuješ se složitou business logikou uvnitř loopingu, může se hodit Make Code modul pro zpracování dat přímo ve scénáři bez extra kreditů.
Komu toolkit pomůže nejvíc
Toolkit je pro tebe pokud:
- Narazil jsi na API které vrací data po stránkách a nevíš jak na to
- Nechceš trávit hodiny hledáním správné konfigurace v dokumentaci
- Potřebuješ spolehlivé řešení pro produkční scénář — ne prototyp
- Buduješ integrace pro klienty a chceš rychle dodávat
FAQ
Funguje toolkit s jakýmkoliv API? Ano — toolkit pokrývá čtyři nejrozšířenější typy paginace. Pokud tvoje API používá nestandardní přístup, patterny ti dají základ který snadno upravíš.
Musím platit za Make.com abych mohl toolkit použít? Potřebuješ aktivní Make.com účet. Free plán postačí pro testování, pro produkční use case doporučuji Core nebo vyšší.
Jak dlouho trvá nasazení? U jednoduchých případů 10-15 minut — import, přemapování URL, test. U složitějších integrací počítej s hodinou.
Přestaň přicházet o data
API paginace není složitá, ale vyžaduje správnou logiku. Toolkit ti dá přesně tu logiku — hotovou, otestovanou, připravenou k použití.