v2.logistics.check_polygon_update_status
POST /api/v2/logistics/check_polygon_update_status
Chỉ khả dụng cho người bán tại Brazil. Sử dụng API này để kiểm tra trạng thái của tệp polygon đã tải lên cho kênh BR Entrega Turbo (Channel ID: 90026) bằng cách truy vấn task_id được trả về từ v2.logistics.upload_serviceable_polygon.
Đường dẫn Endpoint
URL: https://partner.shopeemobile.com/api/v2/logistics/check_polygon_update_status
Tham số chung
| Name | Type | Sample | Description |
|---|---|---|---|
| partner_id | int | 1 | Partner ID được cấp khi đăng ký thành công. Bắt buộc cho mọi yêu cầu. |
| timestamp | timestamp | 1610000000 | Dùng để xác định thời điểm của yêu cầu. Bắt buộc cho mọi yêu cầu. Hết hạn sau 5 phút. |
| access_token | string | c09222e3fc40ffb25fc947f738b1abf1 | Token truy cập API, dùng để xác định quyền truy cập của bạn. Có thể sử dụng nhiều lần và hết hạn sau 4 giờ. |
| shop_id | int | 600000 | Mã định danh duy nhất của cửa hàng trên Shopee. Bắt buộc cho hầu hết các API. |
| sign | string | e318d3e932719916a9f9ebb57e2011961bd47abfa54a36e040d050d8931596e2 | Chữ ký được tạo từ partner_id, đường dẫn API, timestamp, access_token, shop_id và partner_key thông qua thuật toán HMAC-SHA256. Chi tiết: https://open.shopee.com/documents?module=87&type=2&id=58&version=2 |
Tham số Request
| Name | Type | Required | Sample | Description |
|---|---|---|---|---|
| task_id | string | True | test_task_id | ID cần kiểm tra. Vui lòng truyền task_id được trả về từ v2.logistics.upload_serviceable_polygon. |
Tham số Response
| Name | Type | Sample | Description |
|---|---|---|---|
| error | string | error_server | Cho biết loại lỗi nếu có lỗi xảy ra. Để trống nếu không có lỗi. |
| message | string | Error Details : task not found | Cho biết chi tiết lỗi nếu có lỗi xảy ra. Để trống nếu không có lỗi. |
| request_id | string | a316752d608baf000b2c73e2e5eed5c8 | Mã định danh của yêu cầu API để theo dõi lỗi. |
| response | object | Thông tin chi tiết bạn đang truy vấn. | |
| status | int32 | 0 | Trạng thái tải lên tệp polygon khu vực phục vụ. Các giá trị: 0: Tác vụ hoàn thành 1: Tác vụ đang xử lý 2: Lỗi liên quan đến tệp KML |
| message | string | task completed | Chi tiết trạng thái tải lên, ví dụ "task in progress". |