Odoslanie podpísanej skúšobnej udalosti na URL webhooku
- V sandboxe
Jednoducho povedané
Telo obsahuje event_id, type (vždy test), occurred_at a message a podpisuje sa ako stavová udalosť. Nehlási žiadnu faktúru. Od 0.16.0 každý parameter dotazu odpovie 400.
apiKeyAuthorizationBearer <token>Kľúč posielajte ako token typu Bearer: Authorization: Bearer <your-api-key>. Stav služby je jediné volanie, ktoré nevyžaduje kľúč.
Čo odpovedal koncový bod partnera.
application/json- response
delivered*booleanhttp_status*integer|nullduration_ms*integercurl -X POST "https://example.com/webhook/test" \ -H "Authorization: Bearer <your-api-key>"{ "delivered": true, "http_status": 0, "duration_ms": 0}Nastavenie URL webhooku alebo výmena jeho tajného kľúča PUT
Kľúč operátora nastavuje webhook operátora, ktorý dostáva udalosti všetkých klientov; administrátorský kľúč klienta nastavuje webhook tohto klienta, ktorý dostáva len jeho udalosti. Prvé volanie potrebuje url a vytvorí tajný kľúč, ktorý sa vráti raz. Výmena vráti nový tajný kľúč raz. Po 24 hodín služba podpisuje každé doručenie novým aj starým tajným kľúčom, aby mohol partner prepnúť bez straty udalostí. Doručujú sa len udalosti zapísané po prvom volaní. URL musí byť https a každá adresa, na ktorú sa jeho hostiteľ preloží, musí byť verejná: loopback, privátne adresy, link-local, carrier-grade NAT, multicast, rezervované a metadátové adresy cloudu sa odmietajú, tu aj znova pred každým doručením. Presmerovania sa nesledujú. Od 0.16.0 každý parameter dotazu odpovie 400, takže chybne napísaný client nikdy nemôže zmeniť webhook operátora.
Hostovaný sandbox a ako požiadať o kľúč.