API vagy webhook?
| Publikus API | Webhook | |
|---|---|---|
| Ki kezdeményez? | A te rendszered kérdez. | A Pagioo értesít. |
| Mikor fut? | Amikor te hívod. | Amikor az esemény megtörténik. |
| Mire jó? | Adat kiolvasása, művelet indítása. | Azonnali reagálás egy történésre. |
| Tipikus példa | Havi riport generálása a publikált tartalmakból. | Publikálás után bejegyzés létrehozása egy belső rendszerben. |
Tipikus használati esetek
- Tartalomállapot továbbítása belső rendszerbe — hogy a projektmenedzsmentben is látszódjon, mi hol tart.
- Publikálási esemény kezelése — értesítés egy belső csatornán, vagy bejegyzés létrehozása egy nyilvántartásban.
- Saját portál vagy CMS feltöltése — ha a publikálást a saját rendszered irányítja.
- Egyedi riport- vagy értesítési folyamat — a Pagioo adataiból saját kimutatás.
Mi kell az induláshoz?
Scale csomag
A publikus API és a webhookok Scale csomagban érhetők el.
Hozzáférési kulcs
A Beállításokban generálható. A kulcs a fiókod nevében jár el, ezért úgy kezeld, mint egy jelszót.
Webhook-végpont
Egy általad üzemeltetett cím, ami fogadja az értesítéseket. Ellenőrizd a bejövő kérések hitelességét.
Fejlesztői dokumentáció
A végpontok, az események, a korlátok és a hibakódok a fejlesztői dokumentációban vannak. Kérd el tőlünk, ha Scale csomagon vagy.
Elérhető az API kisebb csomagban?
Nem, a publikus API és a webhookok Scale csomagban elérhetők. Kisebb csomagban a kimenő egyéni API-s publikálás viszont használható.
Vannak hívásszámkorlátok?
Igen, a rate limitek és a támogatási keret a fejlesztői dokumentációban vannak meghatározva.
Mi történik, ha a webhook-végpontom nem válaszol?
A rendszer naplózza a sikertelen értesítést. Ezért érdemes a végponton gyorsan válaszolni, és a tényleges feldolgozást a válasz után, saját háttérfolyamatban elvégezni.