Webhook Endpoint

Liệt kê điểm cuối Webhook

Liệt kê điểm cuối Webhook trong workspace hiện tại, gồm sự kiện đăng ký, trạng thái ký, trạng thái và retry policy.

GEThttps://api.unifyport.ai/v1/webhook-endpoints

Trước khi gọi

Dùng X-Api-Key của workspace sở hữu tài nguyên trên máy chủ. Thay mọi giá trị mẫu trước khi chạy.

Tham số yêu cầu

Tiêu đề

X-Api-Key

stringbắt buộc

API key của không gian làm việc. Không gian làm việc được xác định từ tiêu đề này.

Nội dung yêu cầu

Điểm cuối này không cần nội dung JSON.

Hiểu kết quả

Cấu hình thành công không chứng minh đã giao sự kiện. Tạo sự kiện phù hợp rồi kiểm tra nhận, chữ ký và xác nhận tại máy nhận.

Phản hồi 200 OK

{
  "request_id": "<REQUEST_ID>",
  "data": [
    {
      "id": "we_example",
      "url": "https://example.com/webhook",
      "status": "active",
      "subscribed_events": [
        "message.received"
      ],
      "signing_enabled": true,
      "retry_policy": {
        "max_attempts": 3
      }
    }
  ]
}

Nội dung phản hồi

id

string

Định danh điểm cuối webhook (we_...).

url

string

URL HTTP(S) tuyệt đối nhận webhook; production nên dùng HTTPS.

format: uri

status

string

Trạng thái điểm cuối: active hoặc inactive.

enum: active, inactive

subscribed_events[]

string[]

Public standard event của điểm cuối; ["*"] nghĩa là mọi public event, không gồm provider.raw_event.

signing_enabled

boolean

true khi đã đặt secret ký và các lượt gửi được ký.

retry_policy

object

max_attempts đếm retry sau lần gửi đầu, mặc định 3, phạm vi 0–5.

max_attempts

integer

Số lần retry đã cấu hình sau lần gửi đầu, từ 0 đến 5.

Phản hồi

200

200 OK

Yêu cầu thành công. Xem ví dụ nội dung phản hồi.

401

Unauthorized

Header X-Api-Key thiếu hoặc không hợp lệ.

500

Internal Server Error

Dịch vụ gặp lỗi không mong muốn.

Khi yêu cầu thất bại

Kiểm tra HTTP và error.code/numeric_code, giữ request_id. Sửa tham số, tiếp tục xác thực hoặc kiểm tra runtime tùy nguyên nhân. Xác nhận kết quả cũ trước khi thử lại thao tác gửi hoặc ghi. Tham chiếu mã lỗi

invalid_request · 10000 · 400: Kiểm tra trường bắt buộc, định dạng và điều kiện kênh rồi sửa yêu cầu.
invalid_api_key · 11001 · 401: Kiểm tra X-Api-Key và workspace còn hoạt động.