Cấu hình Webhook

Cấu hình Webhook

Webhook cho phép ThueAPI gửi thông báo tự động đến server của bạn khi có giao dịch mới.

Tạo Webhook qua Dashboard

1. Đăng nhập Dashboard → Webhooks
2. Bấm Tạo Webhook
3. Nhập tên, URL endpoint, chọn tài khoản và sự kiện
4. Lưu và copy Secret Key (chỉ hiển thị 1 lần)

Tạo Webhook qua API

POST /api/v1/webhooks
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Request Parameters

Sample Request

curl -sX POST "https://thueapi.vn/api/v1/webhooks" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d \x27{"name": "Webhook đơn hàng", "webhook_url": "https://your-domain.com/webhook", "type": "ALL"}\x27

Sample Response

{
  "status": true,
  "messages": "Tạo webhook thành công",
  "webhook": {
    "id": 2,
    "name": "Webhook đơn hàng",
    "webhook_url": "https://your-domain.com/webhook",
    "type": "ALL",
    "is_active": true
  },
  "secret": "a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6"
}

Yêu cầu URL Webhook

• Phải truy cập được từ internet (không phải localhost)
• Khuyến nghị HTTPS
• Phải phản hồi trong vòng 10 giây
• Phải trả về HTTP 200

Retry Logic