v2.logistics.get_address_list
GET /api/v2/logistics/get_address_list
Đối với kênh vận chuyển tích hợp, dùng API này để lấy địa chỉ lấy hàng cho đơn hàng theo hình thức lấy hàng tận nơi.
Đường dẫn Endpoint
URL: https://partner.shopeemobile.com/api/v2/logistics/get_address_list
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 |
Không có tham số yêu cầu.
Tham số Response
| Tên | Kiểu | Mẫu | Mô tả |
|---|---|---|---|
| request_id | string | 675015f4f59943a39f2f69c22da431f8 | Mã định danh cho yêu cầu API, dùng để theo dõi lỗi. |
| error | string | error_auth | 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 | Invalid access_token. | 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. |
| response | object | Thông tin chi tiết bạn đang truy vấn. | |
| show_pickup_address | boolean | false | Có hiển thị địa chỉ lấy hàng hay không. |
| address_list | object[] | Danh sách địa chỉ của cửa hàng. | |
| address_id | int64 | 1173 | Mã định danh của địa chỉ. |
| region | string | Khu vực của địa chỉ được chỉ định. | |
| state | string | Tỉnh/thành của địa chỉ được chỉ định. | |
| city | string | Thành phố của địa chỉ được chỉ định. | |
| address | string | Mô tả địa chỉ được chỉ định. | |
| zipcode | string | Mã bưu chính của địa chỉ được chỉ định. | |
| district | string | Quận/huyện của địa chỉ được chỉ định. | |
| town | string | Phường/xã của địa chỉ được chỉ định. | |
| address_type | string[] | ["DEFAULT_ADDRESS","PICK_UP_ADDRESS"] | Nhãn địa chỉ cửa hàng. Các giá trị có thể: DEFAULT_ADDRESS, PICK_UP_ADDRESS, RETURN_ADDRESS, INBOUND_PICKUP_ADDRESS. |