v2.logistics.update_address
POST /api/v2/logistics/update_address
Dùng API này để cập nhật địa chỉ của một cửa hàng.
Đường dẫn Endpoint
URL: https://partner.shopeemobile.com/api/v2/logistics/update_address
Tham số chung
| Tên | Kiểu | Mẫu | Mô tả |
|---|---|---|---|
| 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 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. 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 băm HMAC-SHA256. Chi tiết: https://open.shopee.com/documents?module=87&type=2&id=58&version=2 |
Tham số Request
| Tên | Kiểu | Bắt buộc | Mẫu | Mô tả |
|---|---|---|---|---|
| address_id | int64 | True | 123456 | Mã định danh duy nhất của địa chỉ. Có thể lấy address_id qua v2.logistics.get_address_list. |
| region | string | False | Brazil | Khu vực của địa chỉ. Lưu ý: Không được phép cập nhật khu vực của địa chỉ. |
| state | string | False | SP | Tỉnh/thành của địa chỉ. |
| city | string | False | São Paulo | Thành phố của địa chỉ. |
| district | string | False | Pinheiros | Quận/huyện của địa chỉ. |
| town | string | False | Rua dos Pinheiros | Phường/xã của địa chỉ. |
| address | string | False | 123 Rua dos Pinheiros Apt 45 | Mô tả chi tiết địa chỉ. |
| zipcode | string | False | 05422-001 | Mã bưu chính của địa chỉ. |
| name | string | False | Carlos Silva | Tên người nhận tại địa chỉ này. |
| phone | string | False | +55-11-91234-5678 | Số điện thoại liên hệ của người nhận. |
| geo_info | string | False | Thông tin tọa độ địa lý của địa chỉ. Kiểu: chuỗi JSON. Lưu ý: 1) Để xóa thông tin tọa độ hiện có, truyền "" hoặc {}. 2) Để giữ nguyên thông tin tọa độ hiện có, không bao gồm trường này. 3) JSON có thể bao gồm các trường tùy chọn: formattedAddress (string), region (object - chứa latitude và longitude kiểu float), user_verified (boolean - tọa độ có được người dùng xác minh không), user_adjusted (boolean - tọa độ có được người dùng điều chỉnh không). |
Tham số Response
| Tên | Kiểu | Mẫu | Mô tả |
|---|---|---|---|
| error | string | NOT_ALLOW_TO_EDIT_ADDRESS_REGION | 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 | The param is invalid. not allow to edit address region. | 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 | 6745b892295d750abf83a29430510400 | Mã định danh cho yêu cầu API, dùng để theo dõi lỗi. |