Webhooks

Vérifiez la signature sur l’horodatage, un point et le corps brut exact. Conservez les ID pour ignorer les doublons. Une nouvelle livraison ne relance pas la génération.

Ajouter un webhook#

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"  ]}'

Configuration

curl --version

Choisissez une clé ou connexion avec webhooks:manage et operations:read.

Vérifier la signature#

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)

Historique des livraisons#

HTTP

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

GET /v1/webhook-endpointsConsultez la ressource sélectionnée de votre compte ou l’état du flux sans lancer de génération.POST /v1/webhook-endpointsUtilisez les champs et autorisations documentés pour ce point de terminaison HTTP.PATCH /v1/webhook-endpoints/{id}Utilisez les champs et autorisations documentés pour ce point de terminaison HTTP.POST /v1/webhook-endpoints/{id}/rotate-secretUtilisez les champs et autorisations documentés pour ce point de terminaison HTTP.GET /v1/webhook-endpoints/{id}/deliveriesConsultez la ressource sélectionnée de votre compte ou l’état du flux sans lancer de génération.POST /v1/webhook-endpoints/{id}/deliveries/{delivery_id}/retryUtilisez les champs et autorisations documentés pour ce point de terminaison HTTP.