Ein signiertes Testereignis an die Webhook-URL senden
- In der Sandbox
In einfachen Worten
Der Body enthält event_id, type (immer test), occurred_at und message, signiert wie ein Statusereignis. Er meldet keine Rechnung. Seit 0.16.0 wird jeder Query-Parameter mit 400 beantwortet.
apiKeyAuthorizationBearer <token>Senden Sie Ihren Schlüssel als Bearer-Token: Authorization: Bearer <your-api-key>. Der Systemzustand ist der einzige Aufruf, der keinen Schlüssel braucht.
Was der Endpunkt des Partners geantwortet hat.
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}Die Webhook-URL setzen oder ihr Secret rotieren PUT
Der Schlüssel des Betreibers setzt den Webhook des Betreibers, der die Ereignisse aller Kunden erhält; der Admin-Schlüssel eines Kunden setzt den eigenen Webhook dieses Kunden, der nur dessen Ereignisse erhält. Der erste Aufruf braucht url und erzeugt das Secret, das einmal zurückgegeben wird. Beim Rotieren wird das neue Secret einmal zurückgegeben. 24 Stunden lang signiert der Service jede Zustellung mit dem neuen und dem alten Secret, damit der Partner umstellen kann, ohne Ereignisse zu verlieren. Zugestellt werden nur Ereignisse, die nach dem ersten Aufruf geschrieben wurden. Die URL muss https sein, und jede Adresse, auf die ihr Host auflöst, muss öffentlich sein: Loopback-, private, Link-Local-, Carrier-Grade-NAT-, Multicast-, reservierte und Cloud-Metadaten-Adressen werden abgelehnt, hier und erneut vor jeder Zustellung. Weiterleitungen werden nicht verfolgt. Seit 0.16.0 wird jeder Query-Parameter mit 400 beantwortet, sodass ein falsch geschriebenes client nie den Webhook des Betreibers ändern kann.
Die gehostete Sandbox und wie Sie einen Schlüssel anfragen.