Zapisnik isporuka webhooka
- U sandboxu
Od 0.28.0. Isporuke jednog webhooka, od najnovijeg pokušaja (one bez pokušaja zadnje), sa stanjem, neuspjesima i vremenima svake isporuke, bez samog događaja. Ključ klijenta s opsegom read čita webhook svojeg klijenta (navođenje drugog klijenta vraća 404); operaterov ključ čita operaterov webhook ili webhook jednog klijenta uz client; operaterov ključ samo za čitanje čita isto. Najviše limit redaka (zadano 100, najviše 500), uz truncated kad ih ima više.
apiKeyAuthorizationBearer <token>Ključ pošaljite kao bearer token: Authorization: Bearer <your-api-key>. Poziv za stanje usluge jedini je poziv za koji nije potreban ključ.
client?string^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$state?string"pending""delivered""dead"limit?integer1 <= value <= 500100Isporuke.
application/json- response
data*array<>truncated*booleancurl -X GET "https://example.com/webhook/deliveries" \ -H "Authorization: Bearer <your-api-key>"{ "data": [ { "invoice_id": "string", "sequence": 0, "event_id": "string", "state": "pending", "failures": 0, "first_failure_at": "2019-08-24T14:15:22Z", "last_attempt_at": "2019-08-24T14:15:22Z" } ], "truncated": true}Dohvati postavke webhooka (operatera ili, s admin ključem klijenta, postavke tog klijenta) GET
Od 0.16.0 ključ operatera čita postavke jednog klijenta pomoću client. Admin ključ klijenta smije navesti samo svojeg klijenta; svaki drugi vraća 404. Nepoznat ili ponovljen parametar, ili prazan client, vraća 400. Postavljanje i testiranje webhooka ne prima nikakve parametre upita (400): oni ostaju uz ključ samog webhooka.
Postavi URL webhooka ili rotiraj njegovu tajnu PUT
Ključ operatera postavlja webhook operatera, koji prima događaje svih klijenata; admin ključ klijenta postavlja webhook tog klijenta, koji prima samo njegove događaje. Prvi poziv treba url i stvara tajnu, koja se vraća jednom. Rotacija vraća novu tajnu jednom. Kroz 24 sata usluga potpisuje svaku isporuku i novom i starom tajnom, pa partner može prijeći bez gubitka događaja. Isporučuju se samo događaji zapisani nakon prvog poziva. URL mora biti https, a svaka adresa na koju se njegov host razrješava mora biti javna: loopback, privatne, link-local, carrier-grade NAT, multicast, rezervirane adrese i adrese metapodataka oblaka odbijaju se, ovdje i ponovno prije svake isporuke. Preusmjeravanja se ne slijede. Od 0.16.0 svaki parametar upita vraća 400, pa pogrešno napisan client nikad ne može promijeniti webhook samog operatera.