Bỏ qua đến nội dung
ShopNexus Docs
Trên trang này Quy tắc cho client 1/2

Endpoint nào khởi động một luồng bền vững (durable flow) đều bắt buộc header Idempotency-Key. Server chạy luồng đó trong Restate với key này, nên key lặp lại sẽ gắn vào lần chạy đầu và trả kết quả của nó, không chạy lần hai. Người dùng bấm lại sau khi timeout vẫn nhận cùng câu trả lời, không sinh thêm tin đăng, tin nhắn hay đơn hàng.

Idempotency-Key: 0192a4e1-7b3c-7d2e-9f10-5a6b7c8d9e0f

Quy tắc cho client

  • Mỗi thao tác của người dùng tạo một UUID mới.
  • Gửi lại thao tác đó thì dùng lại đúng key cũ, dù app tự retry hay người dùng bấm lại sau khi báo lỗi.
  • Không bao giờ dùng chung một key cho hai thao tác khác nhau.

Thiếu key hoặc key sai định dạng trả 400 invalid_request.

Endpoint nào cần

Spec đánh dấu từng endpoint. Hiện tại gồm: đăng nhập, tạo và sửa tin đăng, thêm địa chỉ, mở cuộc trò chuyện, gửi tin nhắn, và các bước giao hàng của người bán trên đơn (đã gửi, đã giao, đã hoàn).

Một số key có phạm vi riêng. Đăng nhập ghép key với số điện thoại đã xác minh, đăng tin ghép key với người bán. Cùng key nhưng gửi kèm token của số khác, hoặc do người bán khác gửi, sẽ chạy thành lần riêng.

Cập nhật hồ sơ kèm ảnh đại diện mới thì không cần key. Bước xử lý ảnh đã được khóa theo ID của upload, nên gửi lại vẫn gắn vào lần chạy đầu.

ShopNexus Docs
EN VI

Gợi ý cho trang này

Thao tác nhanh