sangtao.ai
API key

Webhook

Gửi thử

Gửi thử một sự kiện ngay và xem URL của bạn trả gì.

POSThttps://api.sangtao.ai/v2/webhooks/{id}/test

Xác thực

  • X-Api-Keystring · headerbắt buộc

    API key của bạn, tạo ở trang API key trong tài khoản.

Tham số đường dẫn

  • idstringbắt buộc

    ID trong đường dẫn.

Gửi ngay sự kiện webhook.test tới endpoint này và trả kết quả lần gửi đầu. Hỏng thì tự thử lại theo lịch như mọi lần giao.

Response

  • deliveryIdstringbắt buộc

    Lần giao, dlv_…

  • eventIdstringbắt buộc

    Sự kiện, evt_… — là id trong body đã gửi

  • statusstringbắt buộc

    pending: hỏng, sẽ thử lại theo lịch

    Giá trị có thể:succeededpendingfailed

  • httpStatusnumber | null

    Mã URL của bạn trả về. null khi không kết nối được

  • durationMsnumberbắt buộc

    Thời gian gửi

  • errorstring | null

    Lý do hỏng

Mã lỗi

MãerrorCodeKhi nào
404WEBHOOK_NOT_FOUNDKhông có endpoint nào của bạn với id này
409WEBHOOK_DISABLEDEndpoint đang tắt — PATCH enabled: true trước
POST/webhooks/{id}/test
curl -X POST "https://api.sangtao.ai/v2/webhooks/whk_4nP8rT2xK/test" \
  -H "X-Api-Key: YOUR_API_KEY"
{
  "success": true,
  "data": {
    "deliveryId": "dlv_2Hc7wNe4F",
    "eventId": "evt_1Lp6sYb3R",
    "status": "succeeded",
    "httpStatus": 200,
    "durationMs": 182,
    "error": null
  }
}