更新时间：2025-04-01 GMT+08:00
列举仓
功能介绍
一个账户下可以创建最多25个仓，每个仓可以创建最多100个store，响应中一次性返回所有仓名称。
URI
POST /v1/list-store
请求参数
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
cursor_name | 否 | String | 上次返回的游标位置，本次响应包含该仓名。
|
limit | 否 | Integer | 响应返回的仓个数。 |
响应参数
状态码：200
参数 | 参数类型 | 描述 |
|---|---|---|
cursor_name | String | 本次响应后的游标位置，下次请求时携带。
说明： 如果为空，表示后面无更多仓名。 |
stores | Array of strings | 返回的仓名列表。 |
状态码：400
参数 | 参数类型 | 描述 |
|---|---|---|
error_code | String | 请求返回的错误码。 |
error_msg | String | 请求返回的错误信息。 |
请求示例
列举用户账户下的仓，从指定仓名位置开始返回，限制返回仓名数量2个。
POST https://{endpoint}/v1/list-store
{
"limit" : 2
} 响应示例
状态码：200
表示列举仓成功。
{
"cursor_name" : "test-store-name-3",
"store_name_list" : [ "test-store-name-1", "test-store-name-2" ]
} 状态码
状态码 | 描述 |
|---|---|
200 | 表示列举仓成功。 |
400 | BadRequest |
错误码
请参见错误码。
父主题：仓接口
