Webhooks
Verifique a assinatura do timestamp, ponto e corpo bruto exato. Guarde IDs para ignorar duplicatas. Repetir uma entrega não repete a geração.
Adicionar 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" ]}'Configuração
curl --versionEscolha uma chave ou conexão com webhooks:manage e operations:read.
Verificar assinatura#
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)Histórico de entregas#
POST /v1/webhook-endpoints/{id}/rotate-secretGET /v1/webhook-endpoints/{id}/deliveriesPOST /v1/webhook-endpoints/{id}/deliveries/{delivery_id}/retryGET /v1/webhook-endpointsConsulte o recurso da sua conta ou o estado do fluxo sem iniciar uma geração.POST /v1/webhook-endpointsUse os campos e permissões documentados para este endpoint HTTP.PATCH /v1/webhook-endpoints/{id}Use os campos e permissões documentados para este endpoint HTTP.POST /v1/webhook-endpoints/{id}/rotate-secretUse os campos e permissões documentados para este endpoint HTTP.GET /v1/webhook-endpoints/{id}/deliveriesConsulte o recurso da sua conta ou o estado do fluxo sem iniciar uma geração.POST /v1/webhook-endpoints/{id}/deliveries/{delivery_id}/retryUse os campos e permissões documentados para este endpoint HTTP.