Een ondertekend testbericht naar de webhook-URL sturen
- In de sandbox
In gewone woorden
De body bevat event_id, type (altijd test), occurred_at en message, ondertekend zoals een statusbericht. Het meldt geen factuur. Sinds 0.16.0 geeft elke queryparameter 400.
apiKeyAuthorizationBearer <token>Stuur uw sleutel als bearer-token: Authorization: Bearer <your-api-key>. De health-aanroep is de enige aanroep die geen sleutel vereist.
Wat het eindpunt van de partner antwoordde.
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}De webhook-URL instellen, of het geheim vernieuwen PUT
De sleutel van de beheerder stelt de webhook van de beheerder in, die de berichten van alle eindklanten krijgt; de beheerderssleutel van een eindklant stelt die van de eigen eindklant in, die alleen zijn berichten krijgt. De eerste aanroep heeft url nodig en maakt het geheim aan, dat eenmalig wordt teruggegeven. Vernieuwen geeft het nieuwe geheim eenmalig terug. Gedurende 24 uur ondertekent de dienst elke aflevering met zowel het nieuwe als het oude geheim, zodat de partner kan overstappen zonder berichten te verliezen. Alleen berichten die na de eerste aanroep zijn geschreven, worden afgeleverd. De URL moet https zijn, en elk adres waarnaar de host verwijst, moet openbaar zijn: loopback-, privé-, link-local-, carrier-grade-NAT-, multicast-, gereserveerde en cloudmetadata-adressen worden geweigerd, hier en opnieuw vóór elke aflevering. Doorverwijzingen worden niet gevolgd. Sinds 0.16.0 geeft elke queryparameter 400, zodat een verkeerd gespelde client de eigen webhook van de beheerder nooit kan wijzigen.
De gehoste sandbox, en hoe u om een sleutel vraagt.