v2.logistics.upload_serviceable_polygon
POST /api/v2/logistics/upload_serviceable_polygon
Chỉ khả dụng cho người bán Brazil. Dùng API này để tải lên file KML để cài đặt khu vực phục vụ ở cấp độ cửa hàng cho kênh BR Entrega Turbo (Channel ID: 90026). Lưu ý: các Outlet Shop thuộc cùng một Mart Shop không được có khu vực phục vụ chồng lấp.
Đường dẫn Endpoint
URL: https://partner.shopeemobile.com/api/v2/logistics/upload_serviceable_polygon
Tham số chung
| Name | Type | Sample | Description |
|---|---|---|---|
| partner_id | int | 1 | Partner ID được gán khi đăng ký thành công. Bắt buộc cho tất cả các yêu cầu. |
| timestamp | timestamp | 1610000000 | Dùng để chỉ định thời điểm gửi yêu cầu. Bắt buộc cho tất cả các yêu cầu. Hết hạn sau 5 phút. |
| access_token | string | c09222e3fc40ffb25fc947f738b1abf1 | Token dùng để truy cập API, xác định quyền của bạn. Có thể 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 Shopee cho một cửa hàng. Tham số 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 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 |
|---|---|---|---|---|
| file | file | True | File .kml cần tải lên để biểu thị khu vực phục vụ của cửa hàng. Tham khảo định dạng file KML cho v2.logistics.upload_serviceable_polygon để hiểu cấu trúc và yêu cầu tải lên. |
Tham số Response
| Name | Type | Sample | Description |
|---|---|---|---|
| error | string | error_param | Cho biết loại lỗi nếu xảy ra. Trống nếu không có lỗi. |
| message | string | File size exceeds max allowable size. | Cho biết chi tiết lỗi nếu 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 dùng để theo dõi lỗi. |
| response | object | Thông tin chi tiết bạn đang truy vấn. | |
| task_id | string | Use the task_id to call v2.logistics.check_polygon_update_status to check if the upload job has been completed. |