Chuyển tới nội dung chính

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ênKiểuMẫuMô tả
partner_idint1Partner ID được cấp khi đăng ký thành công. Bắt buộc cho mọi yêu cầu.
timestamptimestamp1610000000Dù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_tokenstringc09222e3fc40ffb25fc947f738b1abf1Token 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_idint600000Mã đị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.
signstringe318d3e932719916a9f9ebb57e2011961bd47abfa54a36e040d050d8931596e2Chữ 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ênKiểuMẫuMô tả
request_idstring675015f4f59943a39f2f69c22da431f8Mã định danh cho yêu cầu API, dùng để theo dõi lỗi.
errorstringerror_authCho biết loại lỗi nếu có lỗi xảy ra. Để trống nếu không có lỗi.
messagestringInvalid 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.
responseobjectThông tin chi tiết bạn đang truy vấn.
show_pickup_addressbooleanfalseCó hiển thị địa chỉ lấy hàng hay không.
address_listobject[]Danh sách địa chỉ của cửa hàng.
address_idint641173Mã định danh của địa chỉ.
regionstringKhu vực của địa chỉ được chỉ định.
statestringTỉnh/thành của địa chỉ được chỉ định.
citystringThành phố của địa chỉ được chỉ định.
addressstringMô tả địa chỉ được chỉ định.
zipcodestringMã bưu chính của địa chỉ được chỉ định.
districtstringQuận/huyện của địa chỉ được chỉ định.
townstringPhường/xã của địa chỉ được chỉ định.
address_typestring[]["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.