仓库和仓库组列表
方法适用于模式:FBS, Express 和 DBS.
如果您使用API-Key令牌,调用该方法时需要具备列表中可用权限之一
我应该使用哪种方法而不是过时的方法?
返回仓库列表,如果合并了仓库,则返回仓库组列表。 什么是仓库组,为什么需要它们?
除其他外,该请求允许您确定在为一组仓库转移余额时要使用的标识符。
| ⚙️ 限制: 每分钟100个请求 |
|---|
Request
GET
https://api.partner.market.yandex.ru/v2/businesses/{businessId}/warehouses
Path parameters
|
Name |
Description |
|
businessId* |
Type: integer<int64> 内阁ID。 要找到答案,请使用请求 GET v2/campaigns. Min value: |
Responses
200 OK
仓库和仓库组的列表。
Body
application/json
{
"status": "OK",
"result": {
"warehouses": [
{
"id": 0,
"name": "string",
"campaignId": 0,
"express": false,
"address": {
"city": "string",
"street": "string",
"number": "string",
"building": "string",
"block": "string",
"gps": {
"latitude": 0,
"longitude": 0
}
}
}
],
"warehouseGroups": [
{
"name": "string",
"mainWarehouse": {
"id": 0,
"name": "string",
"campaignId": 0,
"express": false,
"address": {
"city": "string",
"street": "string",
"number": "string",
"building": "string",
"block": "string",
"gps": {
"latitude": 0,
"longitude": 0
}
}
},
"warehouses": [
{
"id": 0,
"name": "string",
"campaignId": 0,
"express": false,
"address": {
"city": "string",
"street": "string",
"number": "string",
"building": "string",
"block": "string",
"gps": {
"latitude": 0,
"longitude": 0
}
}
}
]
}
]
}
}
|
Name |
Description |
|
status* |
Type: ApiResponseStatusType 响应的类型。 可能的值:
Enum: |
|
result |
Type: WarehousesDTO 有关仓库和仓库组的信息。 |
ApiResponseStatusType
响应的类型。 可能的值:
OK— 没有错误。ERROR— 处理请求时出错。
|
Type |
Description |
|
Enum: |
WarehousesDTO
有关仓库和仓库组的信息。
|
Name |
Description |
|
warehouseGroups* |
Type: WarehouseGroupDTO[] 仓库组列表。 |
|
warehouses* |
Type: WarehouseDTO[] 未包含在组中的仓库列表。 |
WarehouseGroupDTO
仓库组的信息。
|
Name |
Description |
|
mainWarehouse* |
Type: WarehouseDTO 有关仓库的信息。 |
|
name* |
Type: string 仓库组的名称。 |
|
warehouses* |
Type: WarehouseDTO[] 组中包含的仓库列表。 |
WarehouseDTO
有关仓库的信息。
|
Name |
Description |
|
campaignId* |
Type: integer<int64> 活动ID。 您可以使用查询找到它 GET v2/campaigns 或者在市场上的卖家办公室找到 — 点击您的帐户图标→ 设置 在左边的菜单中,选择 Api和模块:
⚠️ 不要发送商店ID,这是在市场上的卖家帐户旁边的商店名称和一些报告。 |
|
express* |
Type: boolean 是否可以根据模型交付 Express. |
|
id* |
Type: integer<int64> 仓库ID。 |
|
name* |
Type: string 仓库的名称。 |
|
address |
Type: WarehouseAddressDTO Адрес склада. |
WarehouseAddressDTO
仓库地址。
|
Name |
Description |
|
city* |
Type: string 城市。 Max length: |
|
gps* |
Type: GpsDTO 纬度和经度的GPS坐标。 |
|
block |
Type: string 建筑物编号。 Max length: |
|
building |
Type: string 建筑物编号。 Max length: |
|
number |
Type: string 门牌号。 Max length: |
|
street |
Type: string 街道。 Max length: |
GpsDTO
纬度和经度的GPS坐标。
|
Name |
Description |
|
latitude* |
Type: number 宽度。 |
|
longitude* |
Type: number 经度。 |
400 Bad Request
请求包含不正确的数据。 有关错误的更多信息
Body
application/json
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
|
Name |
Description |
|
errors |
Type: ApiErrorDTO[] 错误列表。 Min items: |
|
status |
Type: ApiResponseStatusType 响应的类型。 可能的值:
Enum: |
ApiErrorDTO
一般错误格式。
|
Name |
Description |
|
code* |
Type: string 的错误代码。 |
|
message |
Type: string 错误的描述。 |
401 Unauthorized
请求中未指定授权数据。 有关错误的更多信息
Body
application/json
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
|
Name |
Description |
|
errors |
Type: ApiErrorDTO[] 错误列表。 Min items: |
|
status |
Type: ApiResponseStatusType 响应的类型。 可能的值:
Enum: |
403 Forbidden
授权数据不正确或禁止访问资源。 有关错误的更多信息
Body
application/json
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
|
Name |
Description |
|
errors |
Type: ApiErrorDTO[] 错误列表。 Min items: |
|
status |
Type: ApiResponseStatusType 响应的类型。 可能的值:
Enum: |
404 Not Found
找不到请求的资源。 有关错误的更多信息
Body
application/json
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
|
Name |
Description |
|
errors |
Type: ApiErrorDTO[] 错误列表。 Min items: |
|
status |
Type: ApiResponseStatusType 响应的类型。 可能的值:
Enum: |
420 Method Failure
已超出资源访问限制。 有关错误的更多信息
Body
application/json
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
|
Name |
Description |
|
errors |
Type: ApiErrorDTO[] 错误列表。 Min items: |
|
status |
Type: ApiResponseStatusType 响应的类型。 可能的值:
Enum: |
500 Internal Server Error
Yandex的内部错误。 市场。 有关错误的更多信息
Body
application/json
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
|
Name |
Description |
|
errors |
Type: ApiErrorDTO[] 错误列表。 Min items: |
|
status |
Type: ApiResponseStatusType 响应的类型。 可能的值:
Enum: |
No longer supported, please use an alternative and newer version.