Nhật ký gửi và kiểm thử
Cài đặt webhook có nhật ký cho từng đích. Dùng xác minh tới máy chủ, chẩn đoán lỗi và gửi mẫu mới không kích hoạt hành động thật.
Xem nhật ký gửi
1
Mở Cài đặt → Webhook
Đi đến
Dashboard → Settings → Webhooks.2
Mở rộng một hàng webhook
Nhấp Nhật ký gửi trên thẻ webhook bất kỳ. Hiện 50 lần thử gửi gần nhất, mới nhất trước.
3
Kiểm tra từng mục
Mỗi hàng hiển thị loại sự kiện, mã trạng thái HTTP, thời gian phản hồi, dấu thời gian và thông báo lỗi nếu có.
Các trường nhật ký
| Trường | Mô tả |
|---|---|
| Sự kiện | Loại sự kiện phát sinh (ví dụ post.saved) |
| Trạng thái | Trạng thái HTTP do điểm cuối của bạn trả về. null nếu hết thời gian chờ hoặc kết nối bị từ chối. |
| Thời gian phản hồi | Thời gian khứ hồi tính bằng mili giây từ lúc gửi tới byte phản hồi cuối. |
| Thành công | Dấu tích xanh = HTTP 2xx. Dấu chéo đỏ = mọi kết quả khác. |
| Lỗi | Thông báo lỗi dễ hiểu cho các lượt gửi thất bại (ví dụ: Request timed out (10s)). |
| Thời điểm gửi | Dấu thời gian UTC của lần gửi. |
Gửi một sự kiện thử
1
Mở rộng thẻ webhook
Trong
Settings → Webhooks, tìm webhook của bạn rồi nhấp Gửi sự kiện thử.2
Kiểm tra nhật ký gửi
Thử xuất hiện đầu nhật ký sau vài giây. Kiểm tra có
200 .Sự kiện thử là yêu cầu HTTP thật
Sự kiện thử đi đúng đường sự kiện thật, gồm HMAC. Mã kiểm chữ ký được chạy đầy đủ.
Không tự động thử lại
Mỗi lượt gửi chỉ được thử một lần. Nhật ký chỉ dùng để chẩn đoán; không có nút phát lại sự kiện trực tiếp đã gửi thất bại. Sau khi sửa điểm cuối, hãy dùng Kiểm tra để xác nhận việc sửa chữa.
Nguyên nhân thất bại thường gặp
| Lỗi / Trạng thái | Nguyên nhân có thể | Cách khắc phục |
|---|---|---|
Request timed out (10s) | Máy chủ mất hơn 10 giây để trả lời | Quay lại 200 ngay lập tức rồi xử lý bất đồng bộ |
401 | Xác minh chữ ký thất bại | Đảm bảo bạn đọc phần thân thô trước khi phân tích JSON |
404 | Đường dẫn URL của điểm cuối không tồn tại | Kiểm tra lại URL trong cài đặt Webhook của Savebase |
500 | Lỗi chưa được xử lý ở bộ nhận | Kiểm tra nhật ký máy chủ để tìm ngoại lệ |
| Kết nối bị từ chối / trạng thái null | Máy chủ ngừng hoặc URL sai | Xác minh máy chủ chạy và truy cập công khai được |