Integrujte EasyCRM do vašich systémov cez REST API.
REST API v1 s granulárnymi rozsahmi oprávnení a autentifikáciou cez bearer token. Odchádzajúce webhooky s HMAC-SHA256 podpisom vás upozornia na vybrané udalosti v CRM.
Granulárne rozsahy oprávnení – presne to, čo integrácia potrebuje
EasyCRM REST API v1 pokrýva kontakty, leady, príležitosti, aktivity, predaj (produkty, cenové ponuky, objednávky), konverzácie zo schránky, záznamy hovorov, reporty, pipeline, vlastné polia, obchodné tímy a synchronizáciu delta zmien. Každý API token nesie explicitné rozsahy oprávnení – napríklad `read:contacts`, `write:opportunities`, `read:reports` alebo `write:calls` – takže integrácia tretej strany má prístup len k tomu, čo potrebuje. Token získate cez `POST /api/v1/auth/token` a posielate ho v hlavičke `Authorization: Bearer <token>`. Limit požiadaviek sa viaže na token a plán: Standard 10 požiadaviek za minútu, Pro až 1 000, plus burst limit 60 požiadaviek za 5 sekúnd. Prístup k API je dostupný od plánu Standard.
- Pomenované rozsahy oprávnení (read/write podľa domény)
- Autentifikácia cez bearer token
- Limit požiadaviek podľa plánu a burst limit 60 req/5 s
- Stránkovanie zoznamových endpointov
- Delta sync endpoint (GET /api/v1/sync/changes)
HMAC-podpísané udalosti s opakovaným doručením
EasyCRM odosiela HTTP POST notifikácie na vašu URL adresu pri vybraných udalostiach. Každý webhook request je podpísaný HMAC-SHA256 pomocou tajného kľúča vášho predplatného – podpis overíte v hlavičke `X-EasyCRM-Signature` (formát `sha256=...`), spolu s hlavičkou `X-EasyCRM-Timestamp`. Odosiela sa šesť udalostí: `lead.converted`, `opportunity.stage_changed`, `deal.won`, `deal.lost`, `call.logged` a `message.received`. Ak váš endpoint nereaguje, EasyCRM doručenie zopakuje až 5-krát s rastúcimi odstupmi; potom udalosť skončí v dead letter queue (DLQ), odkiaľ ju v nastaveniach môžete manuálne doručiť znova. SSRF ochrana blokuje privátne a lokálne IP adresy. Webhooky sú dostupné na pláne Pro.
- Šesť typov webhook udalostí
- HMAC-SHA256 podpis každej udalosti – overovateľný na vašej strane
- Delivery log s HTTP stavom a telom odpovede
- Opakované doručenie a DLQ s manuálnym redelivery
- SSRF ochrana – privátne IP adresy sú blokované
Rozšírte EasyCRM vlastnými pluginmi
EasyCRM poskytuje deklaratívny plugin framework pre integrácie. Plugin je definovaný JSON manifestom, ktorý opisuje požadované rozsahy oprávnení, odoberané webhook udalosti a miesta v rozhraní, kde sa plugin zobrazí. Pri inštalácii administrátor organizácie uvidí obrazovku súhlasu so zoznamom požadovaných rozsahov, udalostí a umiestnení. Po schválení EasyCRM vydá pluginu token s týmito rozsahmi a vytvorí webhook predplatné. Plugin framework je dostupný na pláne Pro.
- Deklaratívny JSON manifest
- Obrazovka súhlasu s rozsahmi pri inštalácii pluginu
- Per-plugin rozsahy oprávnení a odber webhook udalostí
- Miesta v rozhraní CRM pre obsah pluginu
EasyCRM ako stavebný kameň vašich systémov
- API pokrývajúce kontakty, predaj, schránku aj reporty
- Presne vymedzené oprávnenia – integrácia dostane len to, čo potrebuje
- Webhooky s HMAC podpisom – overiteľné na vašej strane
- Opakované doručenie a manuálny redelivery z DLQ
- Plugin framework pre vlastné rozšírenia (Pro)
Otázky pre vývojárov
Prepojte EasyCRM s vašimi nástrojmi cez REST API
Zaregistrujte sa a vyskúšajte API. Prístup k API je dostupný od plánu Standard.