Webhooks

Signatur über Zeitstempel, Punkt und exakten Rohinhalt prüfen. Ereignis-IDs gegen doppelte Zustellung speichern. Erneute Zustellung wiederholt keine Generierung.

Webhook hinzufügen#

curl -X POST 'https://platform.tongai.io/v1/webhook-endpoints' \  -H "Authorization: Bearer $TONG_API_KEY" \  -H "Content-Type: application/json" \  -H "Idempotency-Key: 45be69f1-c266-4a09-a82c-bf3c6303eb03" \  -d '{  "url": "https://your-app.example/tong/events",  "events": [    "operation.succeeded",    "operation.failed",    "operation.review_required",    "usage.settled"  ]}'

Konfiguration

curl --version

Schlüssel oder Verbindung mit webhooks:manage und operations:read wählen.

Signatur prüfen#

HTTP

Tong-Event-Id: {event_uuid}Tong-Timestamp: {unix_seconds}Tong-Key-Version: 1Tong-Signature: v1={hex_hmac_sha256}
HMAC_SHA256(signing_secret, timestamp + "." + raw_body)

Zustellverlauf#

HTTP

POST /v1/webhook-endpoints/{id}/rotate-secretGET /v1/webhook-endpoints/{id}/deliveriesPOST /v1/webhook-endpoints/{id}/deliveries/{delivery_id}/retry

GET /v1/webhook-endpointsGewählte eigene Ressource oder aktuellen Ablaufstatus lesen, ohne eine neue Generierung zu starten.POST /v1/webhook-endpointsDokumentierte Anfragefelder und Berechtigungen dieses HTTP-Endpunkts verwenden.PATCH /v1/webhook-endpoints/{id}Dokumentierte Anfragefelder und Berechtigungen dieses HTTP-Endpunkts verwenden.POST /v1/webhook-endpoints/{id}/rotate-secretDokumentierte Anfragefelder und Berechtigungen dieses HTTP-Endpunkts verwenden.GET /v1/webhook-endpoints/{id}/deliveriesGewählte eigene Ressource oder aktuellen Ablaufstatus lesen, ohne eine neue Generierung zu starten.POST /v1/webhook-endpoints/{id}/deliveries/{delivery_id}/retryDokumentierte Anfragefelder und Berechtigungen dieses HTTP-Endpunkts verwenden.