Gửi sự kiện đến hệ thống của bạn với webhooks

Một webhook cho phép IDup gọi địa chỉ web của bạn ngay khi có điều gì đó xảy ra, ví dụ khi một hóa đơn được thanh toán. Mỗi lần gửi đều được ký và lặp lại nếu hệ thống của bạn không trả lời.

Thêm một điểm cuối

1. Mở Webhooks tab và nhấn Thêm điểm cuối.
2. Nhập một Tên và URL. Nó phải có thể truy cập công khai. Địa chỉ bên trong mạng riêng bị từ chối vì lý do bảo mật.
3. Đánh dấu vào Sự kiện bạn muốn.
4. Tùy chọn: chọn một Khóa API. Điểm cuối sau đó chỉ nhận các sự kiện mà khóa này có thể đọc.
5. Báo chí Lưu. IDup hiển thị Bí mật ký của bạn một lần. Lưu trữ nó an toàn.

Sự kiện

• Hóa đơn đã được tạo, Hóa đơn đã thanh toán, Thanh toán đã nhận
• Khách hàng mới, Liên hệ mới, Khách hàng tiềm năng mới, Vé mới
• Báo giá đã được chấp nhận — báo giá mà khách hàng đã chấp nhận

Mỗi giao hàng mang ba tiêu đề: tên sự kiện, số giao hàng và chữ ký. Một lần thử lại giữ nguyên số giao hàng, vì vậy hệ thống của bạn có thể nhận ra các bản sao.

Kiểm tra chữ ký

Hệ thống của bạn nên tính toán một HMAC-SHA256 qua thời gian và nội dung thô với bí mật của bạn, so sánh nó với chữ ký, và từ chối thời gian cũ hơn 5 phút. Nhấn Xác minh chữ ký và ví dụ cho mã đã chuẩn bị sẵn.

Kiểm tra, tạm dừng và gia hạn

• Gửi thử nghiệm gửi một sự kiện thử nghiệm và hiển thị mã HTTP và thời gian thực hiện.
• Tạm dừng dừng giao hàng; Kích hoạt khởi động lại chúng.
• Bí mật cuộn tạo một bí mật mới. Bí mật cũ ngừng hoạt động ngay lập tức.
• Xóa xóa điểm cuối. Nhật ký của nó được giữ lại.

Thử lại và nhật ký

Địa chỉ của bạn phải trả lời với mã 2xx trong vòng 5 giây. Không theo dõi các chuyển hướng. Nếu thất bại, IDup thử lại sau 1 phút, 5 phút, 30 phút, 2 giờ và 12 giờ. Sau lần thử thứ sáu, việc giao hàng được đánh dấu Đã từ bỏ.

Nhật ký hiển thị mỗi lần thử với sự kiện, điểm cuối, lần thử, mã HTTP, thời gian và phần đầu của câu trả lời. Trạng thái là Đang chờ, Đã giao, Thất bại hoặc Đã từ bỏ. Sử dụng Gửi lại để gửi lại một giao hàng.