خطافات الويب
تحقق من التوقيع على الطابع الزمني ثم نقطة ثم نص الطلب الخام المطابق. احفظ معرّفات الأحداث لتجاهل التكرار. إعادة التسليم لا تعيد التوليد.
إضافة خطاف ويب#
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" ]}'الإعدادات
curl --versionاختر مفتاحًا أو اتصالًا بصلاحيتي webhooks:manage وoperations:read.
التحقق من التوقيع#
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)سجل التسليم#
POST /v1/webhook-endpoints/{id}/rotate-secretGET /v1/webhook-endpoints/{id}/deliveriesPOST /v1/webhook-endpoints/{id}/deliveries/{delivery_id}/retryGET /v1/webhook-endpointsاقرأ المورد المحدد الذي تملكه أو حالة المسار دون بدء توليد جديد.POST /v1/webhook-endpointsاستخدم حقول الطلب والأذونات الموثقة لنقطة HTTP هذه.PATCH /v1/webhook-endpoints/{id}استخدم حقول الطلب والأذونات الموثقة لنقطة HTTP هذه.POST /v1/webhook-endpoints/{id}/rotate-secretاستخدم حقول الطلب والأذونات الموثقة لنقطة HTTP هذه.GET /v1/webhook-endpoints/{id}/deliveriesاقرأ المورد المحدد الذي تملكه أو حالة المسار دون بدء توليد جديد.POST /v1/webhook-endpoints/{id}/deliveries/{delivery_id}/retryاستخدم حقول الطلب والأذونات الموثقة لنقطة HTTP هذه.