Kiểm tra việc gửi webhook và khắc phục lỗi.

Đọc nhật ký gửi yêu cầu của điểm cuối webhook Notiondesk, hiểu về các lần thử lại và tạm dừng, tiếp tục điểm cuối bị tạm dừng và khắc phục các lần gửi yêu cầu không thành công.

9 phút đọc

Mỗi điểm cuối đều lưu nhật ký các yêu cầu Notiondesk được gửi đến nó. Sử dụng nhật ký này để xem máy chủ của bạn đã nhận được gì, tại sao yêu cầu thất bại và khi nào nó sẽ được thử lại.

Cách thực hiện nhanh: Vào Cài đặt > Nhà phát triển > Webhooks , mở một điểm cuối và cuộn xuống phần Các lần gửi gần đây . Nhấp vào một hàng để xem phản hồi và nội dung yêu cầu.

Xem các đơn hàng mới giao gần đây

  1. Vào Cài đặt > Nhà phát triển > Webhooks .
  1. Nhấp chuột vào điểm cuối.
  1. Cuộn xuống phần "Các đơn hàng gần đây" .

Danh sách này hiển thị 100 lần giao hàng gần nhất trong 14 ngày qua. Mỗi hàng hiển thị sự kiện, trung tâm trợ giúp (hoặc Không gian làm việc ) mà sự kiện đó đến từ, kết quả và thời gian.

Biểu tượng Trạng thái Ý nghĩa của nó là gì
Kiểm tra màu xanh lá cây Đã giao hàng Máy chủ của bạn đã trả lời với mã trạng thái 2xx.
Đồng hồ màu cam Chưa giải quyết Chưa gửi hoặc đang chờ lần thử tiếp theo. Nếu thất bại, kết quả sẽ hiển thị kèm theo thông báo "đang thử lại" , ví dụ như 503, "đang thử lại".
Chữ thập đỏ Thất bại Mọi lần thử đều thất bại. Dòng này hiển thị kết quả cuối cùng.
Xám trừ Đã hủy Không gửi được vì thiết bị đầu cuối đã bị tạm dừng hoặc tắt, hoặc trung tâm trợ giúp của nó không thể nhận sự kiện nữa trước lần thử tiếp theo.

Mở đơn hàng

Nhấp chuột vào một hàng để mở hàng đó:

  • ID Giao Hàng : có cùng giá trị với tiêu đề X-ND-Delivery, vì vậy bạn có thể tìm thấy yêu cầu trong nhật ký máy chủ của mình.
  • Phản hồi : mã trạng thái hoặc lý do lỗi, thời gian máy chủ xử lý và số lần thử đã thực hiện.
  • Nội dung yêu cầu : JSON chính xác đã được gửi. Nhấp vào Sao chép để sao chép.

Nội dung phản hồi không được lưu trữ. Đối với các sự kiện chứa dữ liệu cá nhân, chẳng hạn như tin nhắn liên hệ, phản hồi, đồng đội và yêu cầu tham gia, nội dung yêu cầu sẽ bị xóa sau khi quá trình gửi hoàn tất.

Thử lại

Việc gửi thư thất bại khi máy chủ của bạn trả lời bằng bất kỳ mã trạng thái nào khác ngoài 2xx, chuyển hướng, không bắt đầu trả lời trong vòng 5 giây hoặc mất tổng cộng hơn 10 giây. Sau đó, Notiondesk sẽ thử lại:

Thử Khi
1 Ngay lập tức
2 1 phút sau lần thử đầu tiên
3 10 phút sau lần thử thứ hai
4 1 giờ sau lần thử thứ ba
5 6 giờ sau lần thử thứ tư

Sau 5 lần thử không thành công, quá trình gửi sẽ được đánh dấu là Thất bại . Các sự kiện kiểm thử và các lần gửi được đánh dấu là Ký không thành công sẽ không được thử lại.

Khi nhiều sự kiện xảy ra cùng lúc, ví dụ như trong quá trình đồng bộ hóa lớn, các gói tin có thể phải chờ trước khi được gửi đi: thường là vài phút, và có thể lên đến một giờ nếu máy chủ của bạn phản hồi chậm. Chúng vẫn ở trạng thái Chờ xử lý và không bị mất.

Khi một điểm cuối bị tạm dừng

Notiondesk tạm dừng một điểm cuối khi 10 lần gửi liên tiếp thất bại sau tất cả các lần thử, và lần thất bại đầu tiên đã xảy ra ít nhất 24 giờ trước. Các sự kiện kiểm thử không được tính.

Khi một điểm cuối bị tạm dừng:

  • Nó hiển thị trạng thái Tạm dừng và ngừng nhận sự kiện. Các lần thử đã được lên kế hoạch trước đó sẽ bị hủy bỏ.
  • Chủ sở hữu không gian làm việc và quản trị viên sẽ nhận được một email với nội dung "Điểm cuối Webhook đã tạm dừng", trong đó có tên điểm cuối, máy chủ lưu trữ và liên kết đến cài đặt webhook của bạn.
  • Các sự kiện từ khoảng thời gian tạm dừng sẽ không được gửi đi sau đó.

Tóm lại là:

  1. Hãy sửa lỗi máy chủ của bạn. Các lý do lỗi trong phần "Các lần giao hàng gần đây" sẽ cho bạn biết điều gì đã xảy ra.
  1. Nhấp vào "Gửi sự kiện kiểm thử" và kiểm tra xem trạng thái hiển thị là " Đã gửi" .
  1. Nhấp vào Tiếp tục .

Điểm cuối bắt đầu nhận các sự kiện mới trở lại và số lần lỗi được tính lại từ đầu.

Nếu điểm cuối của bạn vẫn hoạt động nhưng việc gửi dữ liệu liên tục thất bại, trang điểm cuối sẽ hiển thị "Thất bại kể từ" kèm theo ngày xảy ra lỗi đầu tiên, như một cảnh báo trước khi bị tạm dừng.

Khắc phục lỗi giao hàng không thành công

Khi máy chủ phản hồi, hàng đó sẽ hiển thị mã trạng thái. Nếu không, nó sẽ hiển thị lý do.

Lý do Những gì bạn thấy Chuyện gì đã xảy ra thế Cách khắc phục
Trạng thái lỗi Mã trạng thái, ví dụ như 500 hoặc 401. Máy chủ của bạn đã trả lời bằng lỗi. Hãy kiểm tra nhật ký máy chủ của bạn vào thời điểm đó. Đảm bảo điểm cuối chấp nhận các yêu cầu POST và quá trình kiểm tra chữ ký của bạn sử dụng đúng mã bí mật.
Chuyển hướng bị từ chối Mã chuyển hướng, ví dụ như 301 hoặc 302. Máy chủ của bạn đã chuyển hướng yêu cầu Nhập URL cuối cùng vào phần cài đặt điểm cuối.
Địa chỉ bị chặn Địa chỉ bị chặn Tên miền của bạn trỏ đến một địa chỉ riêng tư hoặc nội bộ. Trỏ tên miền đến máy chủ công cộng
Kết nối thất bại Kết nối thất bại Notiondesk không thể kết nối đến máy chủ của bạn Hãy kiểm tra xem tên miền có phân giải được không, chứng chỉ TLS có hợp lệ không và cổng 443 hoặc 8443 có đang mở không.
Hết thời gian Hết thời gian Máy chủ của bạn không bắt đầu phản hồi trong vòng 5 giây, hoặc mất hơn 10 giây. Trước tiên hãy trả lời bằng 200, sau đó thực hiện các thao tác khác ở chế độ nền.
Ký không thành công Ký không thành công Notiondesk không thể ký yêu cầu Đây là lỗi từ phía chúng tôi và chúng tôi chưa thử lại. Hãy gửi một sự kiện thử nghiệm và liên hệ với chúng tôi nếu sự cố này xảy ra lần nữa.

Gửi sự kiện thử nghiệm

Nhấp vào "Gửi sự kiện kiểm thử" trên trang điểm cuối để gửi sự kiện ping đến điểm cuối đó. Sự kiện này sẽ xuất hiện ở đầu mục "Các lần gửi gần đây" .

  • Sự kiện kiểm thử chỉ được gửi một lần, không có lần gửi lại nào khác.
  • Bạn có thể gửi nó trong khi điểm cuối đang tạm dừng để kiểm tra bản sửa lỗi trước khi tiếp tục.
  • Mỗi không gian làm việc có thể gửi tối đa 20 sự kiện kiểm thử mỗi giờ. Nếu vượt quá số lượng đó, bạn sẽ thấy thông báo "Quá nhiều sự kiện kiểm thử. Vui lòng thử lại sau."

Câu hỏi thường gặp

Tôi có thể gửi lại đơn hàng đã giao không thành công không?

Không. Hãy mở phiếu giao hàng và nhấp vào Sao chép để lấy nội dung yêu cầu nếu bạn cần tự xử lý.

Tại sao phần thân yêu cầu giao hàng lại bị thiếu?

Sự kiện này chứa dữ liệu cá nhân, vì vậy nội dung của nó đã bị xóa sau khi việc giao hàng hoàn tất.

Hàng hóa được lưu giữ trong bao lâu?

14 ngày. Các đơn hàng giao gần đây hiển thị 100 đơn hàng mới nhất.

Liệu một sự kiện kiểm thử thành công có khôi phục lại điểm cuối đã bị tạm dừng không?

Không. Nó chỉ kiểm tra máy chủ của bạn thôi. Nhấp vào Tiếp tục để bắt đầu nhận sự kiện lại.

Điều gì sẽ xảy ra với các sự kiện đang chờ xử lý nếu tôi xóa một điểm cuối (endpoint)?

Chúng không được gửi đi và nhật ký gửi thư của điểm cuối cũng bị xóa cùng với chúng.

Bài viết liên quan

Trang này có hữu ích không?

Still need help? Ask us