查询位置列表

GET 
/openapi/2025-06/locations

返回店铺所有用于配送、库存和订单履约的地点列表。

请求

Query参数

cursor string

分页游标

page_size int32

每页记录数

status enum

状态

sort_by string

排序字段。默认将默认地点排在最前，支持 priority

响应

200

OK

application/json

数据结构

数据结构

codestring

错误码

messagestring

错误信息

data object

locations object[]

位置列表

Array [

iduint64

唯一标识

activeboolean

是否激活

defaultboolean

是否默认

countrystring

国家名称

country_codestring

国家代码（如 CN）

provincestring

省份或州

province_codestring

省份代码

citystring

城市

areastring

地区或区域

addressstring

地址

address1string

主要地址行

namestring

名称

phonestring

电话号码

zipstring

邮政编码

companystring

公司名称

latitudestring

纬度坐标

longitudestring

经度坐标

created_atstring

创建时间，ISO-8601 格式

updated_atstring

最后更新时间，ISO-8601 格式

]

totalint64

总计

cursorstring

分页游标

has_moreboolean

是否有更多记录

示例

{
  "code": "string",
  "message": "string",
  "data": {
    "locations": [
      {
        "id": 0,
        "active": true,
        "default": true,
        "country": "string",
        "country_code": "string",
        "province": "string",
        "province_code": "string",
        "city": "string",
        "area": "string",
        "address": "string",
        "address1": "string",
        "name": "string",
        "phone": "string",
        "zip": "string",
        "company": "string",
        "latitude": "string",
        "longitude": "string",
        "created_at": "string",
        "updated_at": "string"
      }
    ],
    "total": 0,
    "cursor": "string",
    "has_more": true
  }
}