仓库和仓库组列表

Deprecated

方法适用于模式: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

内阁ID。 要找到答案,请使用请求 GET v2/campaigns.

ℹ️ 什么是市场上的橱柜和商店?

Min value: 1

Responses

200 OK

仓库和仓库组的列表。

Body

application/json
{
  "status": "OK",
  "result": {
    "warehouses": [
      {
        "id": 0,
        "name": "example",
        "campaignId": 1,
        "express": true,
        "address": {}
      }
    ],
    "warehouseGroups": [
      {
        "name": "example",
        "mainWarehouse": {},
        "warehouses": [
          null
        ]
      }
    ]
  }
}

Type: object

All of 2 types
  • Type: object

    status

    Type: string

    响应的类型。 可能的值:

    • OK — 没有错误。
    • ERROR — 处理请求时出错。

    Enum: OK, ERROR

    服务器响应的标准包装器。

    Example
    {
      "status": "OK"
    }
    
  • Type: object

    result

    Type: object

    warehouseGroups

    Type: object[]

    mainWarehouse

    Type: object

    campaignId

    Type: integer

    广告系列(商店)的ID — 通过API工作时,代表您在Yandex市场系统中的商店的技术标识符。 它与您的商店唯一链接,但仅用于自动交互。

    您可以使用查询找到它 GET v2/campaigns 或者在市场上的卖家办公室找到它。 点击您的帐户图标→ 设置 在左边的菜单中,选择 Api和模块:

    • 运动ID;
    • 标签 查询日志 →块中的下拉列表 显示日志.

    ⚠️ 不要把它与:

    • 商店的标识符,显示在商家的个人帐户中。
    • 广告活动。

    Min value: 1

    express

    Type: boolean

    是否可以根据模型交付 Express.

    id

    Type: integer

    仓库ID。

    name

    Type: string

    仓库的名称。

    Example: example

    address

    Type: object

    city

    Type: string

    城市。

    Max length: 200

    Example: example

    gps

    Type: object

    latitude

    Type: number

    宽度。

    longitude

    Type: number

    经度。

    纬度和经度的GPS坐标。

    Example
    {
      "latitude": 0.5,
      "longitude": 0.5
    }
    

    block

    Type: string

    建筑物编号。

    Max length: 16

    Example: example

    building

    Type: string

    建筑物编号。

    Max length: 16

    Example: example

    number

    Type: string

    门牌号。

    Max length: 256

    Example: example

    street

    Type: string

    街道。

    Max length: 512

    Example: example

    仓库地址。

    Example
    {
      "city": "example",
      "street": "example",
      "number": "example",
      "building": "example",
      "block": "example",
      "gps": {
        "latitude": 0.5,
        "longitude": 0.5
      }
    }
    

    有关仓库的信息。

    Example
    {
      "id": 0,
      "name": "example",
      "campaignId": 1,
      "express": true,
      "address": {
        "city": "example",
        "street": "example",
        "number": "example",
        "building": "example",
        "block": "example",
        "gps": {
          "latitude": 0.5,
          "longitude": 0.5
        }
      }
    }
    

    name

    Type: string

    仓库组的名称。

    Example: example

    warehouses

    Type: object[]

    campaignId

    Type: integer

    广告系列(商店)的ID — 通过API工作时,代表您在Yandex市场系统中的商店的技术标识符。 它与您的商店唯一链接,但仅用于自动交互。

    您可以使用查询找到它 GET v2/campaigns 或者在市场上的卖家办公室找到它。 点击您的帐户图标→ 设置 在左边的菜单中,选择 Api和模块:

    • 运动ID;
    • 标签 查询日志 →块中的下拉列表 显示日志.

    ⚠️ 不要把它与:

    • 商店的标识符,显示在商家的个人帐户中。
    • 广告活动。

    Min value: 1

    express

    Type: boolean

    是否可以根据模型交付 Express.

    id

    Type: integer

    仓库ID。

    name

    Type: string

    仓库的名称。

    Example: example

    address

    Type: object

    city

    Type: string

    城市。

    Max length: 200

    Example: example

    gps

    Type: object

    latitude

    Type: number

    宽度。

    longitude

    Type: number

    经度。

    纬度和经度的GPS坐标。

    Example
    {
      "latitude": 0.5,
      "longitude": 0.5
    }
    

    block

    Type: string

    建筑物编号。

    Max length: 16

    Example: example

    building

    Type: string

    建筑物编号。

    Max length: 16

    Example: example

    number

    Type: string

    门牌号。

    Max length: 256

    Example: example

    street

    Type: string

    街道。

    Max length: 512

    Example: example

    仓库地址。

    Example
    {
      "city": "example",
      "street": "example",
      "number": "example",
      "building": "example",
      "block": "example",
      "gps": {
        "latitude": 0.5,
        "longitude": 0.5
      }
    }
    

    组中包含的仓库列表。

    Example
    [
      {
        "id": 0,
        "name": "example",
        "campaignId": 1,
        "express": true,
        "address": {
          "city": "example",
          "street": "example",
          "number": "example",
          "building": "example",
          "block": "example",
          "gps": {
            "latitude": 0.5,
            "longitude": 0.5
          }
        }
      }
    ]
    

    仓库组列表。

    Example
    [
      {
        "name": "example",
        "mainWarehouse": {
          "id": 0,
          "name": "example",
          "campaignId": 1,
          "express": true,
          "address": {
            "city": "example",
            "street": "example",
            "number": "example",
            "building": "example",
            "block": "example",
            "gps": {
              "latitude": 0.5,
              "longitude": 0.5
            }
          }
        },
        "warehouses": [
          {
            "id": 0,
            "name": "example",
            "campaignId": 1,
            "express": true,
            "address": {
              "city": "example",
              "street": "example",
              "number": "example",
              "building": "example",
              "block": "example",
              "gps": {}
            }
          }
        ]
      }
    ]
    

    warehouses

    Type: object[]

    campaignId

    Type: integer

    广告系列(商店)的ID — 通过API工作时,代表您在Yandex市场系统中的商店的技术标识符。 它与您的商店唯一链接,但仅用于自动交互。

    您可以使用查询找到它 GET v2/campaigns 或者在市场上的卖家办公室找到它。 点击您的帐户图标→ 设置 在左边的菜单中,选择 Api和模块:

    • 运动ID;
    • 标签 查询日志 →块中的下拉列表 显示日志.

    ⚠️ 不要把它与:

    • 商店的标识符,显示在商家的个人帐户中。
    • 广告活动。

    Min value: 1

    express

    Type: boolean

    是否可以根据模型交付 Express.

    id

    Type: integer

    仓库ID。

    name

    Type: string

    仓库的名称。

    Example: example

    address

    Type: object

    city

    Type: string

    城市。

    Max length: 200

    Example: example

    gps

    Type: object

    latitude

    Type: number

    宽度。

    longitude

    Type: number

    经度。

    纬度和经度的GPS坐标。

    Example
    {
      "latitude": 0.5,
      "longitude": 0.5
    }
    

    block

    Type: string

    建筑物编号。

    Max length: 16

    Example: example

    building

    Type: string

    建筑物编号。

    Max length: 16

    Example: example

    number

    Type: string

    门牌号。

    Max length: 256

    Example: example

    street

    Type: string

    街道。

    Max length: 512

    Example: example

    仓库地址。

    Example
    {
      "city": "example",
      "street": "example",
      "number": "example",
      "building": "example",
      "block": "example",
      "gps": {
        "latitude": 0.5,
        "longitude": 0.5
      }
    }
    

    未包含在组中的仓库列表。

    Example
    [
      {
        "id": 0,
        "name": "example",
        "campaignId": 1,
        "express": true,
        "address": {
          "city": "example",
          "street": "example",
          "number": "example",
          "building": "example",
          "block": "example",
          "gps": {
            "latitude": 0.5,
            "longitude": 0.5
          }
        }
      }
    ]
    

    有关仓库和仓库组的信息。

    Example
    {
      "warehouses": [
        {
          "id": 0,
          "name": "example",
          "campaignId": 1,
          "express": true,
          "address": {
            "city": "example",
            "street": "example",
            "number": "example",
            "building": "example",
            "block": "example",
            "gps": {
              "latitude": 0.5,
              "longitude": 0.5
            }
          }
        }
      ],
      "warehouseGroups": [
        {
          "name": "example",
          "mainWarehouse": {
            "id": 0,
            "name": "example",
            "campaignId": 1,
            "express": true,
            "address": {
              "city": "example",
              "street": "example",
              "number": "example",
              "building": "example",
              "block": "example",
              "gps": {}
            }
          },
          "warehouses": [
            {
              "id": 0,
              "name": "example",
              "campaignId": 1,
              "express": true,
              "address": {}
            }
          ]
        }
      ]
    }
    
    Example
    {
      "result": {
        "warehouses": [
          {
            "id": 0,
            "name": "example",
            "campaignId": 1,
            "express": true,
            "address": {
              "city": "example",
              "street": "example",
              "number": "example",
              "building": "example",
              "block": "example",
              "gps": {}
            }
          }
        ],
        "warehouseGroups": [
          {
            "name": "example",
            "mainWarehouse": {
              "id": 0,
              "name": "example",
              "campaignId": 1,
              "express": true,
              "address": {}
            },
            "warehouses": [
              {}
            ]
          }
        ]
      }
    }
    

400 Bad Request

请求包含不正确的数据。 有关错误的更多信息

Body

application/json
{
  "status": "OK",
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

Type: object

All of 1 type
  • Type: object

    All of 2 types
    • Type: object

      status

      Type: string

      响应的类型。 可能的值:

      • OK — 没有错误。
      • ERROR — 处理请求时出错。

      Enum: OK, ERROR

      服务器响应的标准包装器。

      Example
      {
        "status": "OK"
      }
      
    • Type: object

      errors

      Type: object[]

      code

      Type: string

      的错误代码。

      Example: example

      message

      Type: string

      错误的描述。

      Example: example

      错误列表。

      Min items: 1

      Example
      [
        {
          "code": "example",
          "message": "example"
        }
      ]
      
      Example
      {
        "errors": [
          {
            "code": "example",
            "message": "example"
          }
        ]
      }
      

    服务器错误的标准包装器。

    Example
    {
      "status": "OK",
      "errors": [
        {
          "code": "example",
          "message": "example"
        }
      ]
    }
    

401 Unauthorized

请求中未指定授权数据。 有关错误的更多信息

Body

application/json
{
  "status": "OK",
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

Type: object

All of 1 type
  • Type: object

    All of 2 types
    • Type: object

      status

      Type: string

      响应的类型。 可能的值:

      • OK — 没有错误。
      • ERROR — 处理请求时出错。

      Enum: OK, ERROR

      服务器响应的标准包装器。

      Example
      {
        "status": "OK"
      }
      
    • Type: object

      errors

      Type: object[]

      code

      Type: string

      的错误代码。

      Example: example

      message

      Type: string

      错误的描述。

      Example: example

      错误列表。

      Min items: 1

      Example
      [
        {
          "code": "example",
          "message": "example"
        }
      ]
      
      Example
      {
        "errors": [
          {
            "code": "example",
            "message": "example"
          }
        ]
      }
      

    服务器错误的标准包装器。

    Example
    {
      "status": "OK",
      "errors": [
        {
          "code": "example",
          "message": "example"
        }
      ]
    }
    

403 Forbidden

授权数据不正确或禁止访问资源。 有关错误的更多信息

Body

application/json
{
  "status": "OK",
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

Type: object

All of 1 type
  • Type: object

    All of 2 types
    • Type: object

      status

      Type: string

      响应的类型。 可能的值:

      • OK — 没有错误。
      • ERROR — 处理请求时出错。

      Enum: OK, ERROR

      服务器响应的标准包装器。

      Example
      {
        "status": "OK"
      }
      
    • Type: object

      errors

      Type: object[]

      code

      Type: string

      的错误代码。

      Example: example

      message

      Type: string

      错误的描述。

      Example: example

      错误列表。

      Min items: 1

      Example
      [
        {
          "code": "example",
          "message": "example"
        }
      ]
      
      Example
      {
        "errors": [
          {
            "code": "example",
            "message": "example"
          }
        ]
      }
      

    服务器错误的标准包装器。

    Example
    {
      "status": "OK",
      "errors": [
        {
          "code": "example",
          "message": "example"
        }
      ]
    }
    

404 Not Found

找不到请求的资源。 有关错误的更多信息

Body

application/json
{
  "status": "OK",
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

Type: object

All of 1 type
  • Type: object

    All of 2 types
    • Type: object

      status

      Type: string

      响应的类型。 可能的值:

      • OK — 没有错误。
      • ERROR — 处理请求时出错。

      Enum: OK, ERROR

      服务器响应的标准包装器。

      Example
      {
        "status": "OK"
      }
      
    • Type: object

      errors

      Type: object[]

      code

      Type: string

      的错误代码。

      Example: example

      message

      Type: string

      错误的描述。

      Example: example

      错误列表。

      Min items: 1

      Example
      [
        {
          "code": "example",
          "message": "example"
        }
      ]
      
      Example
      {
        "errors": [
          {
            "code": "example",
            "message": "example"
          }
        ]
      }
      

    服务器错误的标准包装器。

    Example
    {
      "status": "OK",
      "errors": [
        {
          "code": "example",
          "message": "example"
        }
      ]
    }
    

420 Method Failure

已超出资源访问限制。 有关错误的更多信息

Body

application/json
{
  "status": "OK",
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

Type: object

All of 1 type
  • Type: object

    All of 2 types
    • Type: object

      status

      Type: string

      响应的类型。 可能的值:

      • OK — 没有错误。
      • ERROR — 处理请求时出错。

      Enum: OK, ERROR

      服务器响应的标准包装器。

      Example
      {
        "status": "OK"
      }
      
    • Type: object

      errors

      Type: object[]

      code

      Type: string

      的错误代码。

      Example: example

      message

      Type: string

      错误的描述。

      Example: example

      错误列表。

      Min items: 1

      Example
      [
        {
          "code": "example",
          "message": "example"
        }
      ]
      
      Example
      {
        "errors": [
          {
            "code": "example",
            "message": "example"
          }
        ]
      }
      

    服务器错误的标准包装器。

    Example
    {
      "status": "OK",
      "errors": [
        {
          "code": "example",
          "message": "example"
        }
      ]
    }
    

500 Internal Server Error

Yandex中的内部错误。 市场。 有关错误的更多信息

Body

application/json
{
  "status": "OK",
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

Type: object

All of 1 type
  • Type: object

    All of 2 types
    • Type: object

      status

      Type: string

      响应的类型。 可能的值:

      • OK — 没有错误。
      • ERROR — 处理请求时出错。

      Enum: OK, ERROR

      服务器响应的标准包装器。

      Example
      {
        "status": "OK"
      }
      
    • Type: object

      errors

      Type: object[]

      code

      Type: string

      的错误代码。

      Example: example

      message

      Type: string

      错误的描述。

      Example: example

      错误列表。

      Min items: 1

      Example
      [
        {
          "code": "example",
          "message": "example"
        }
      ]
      
      Example
      {
        "errors": [
          {
            "code": "example",
            "message": "example"
          }
        ]
      }
      

    服务器错误的标准包装器。

    Example
    {
      "status": "OK",
      "errors": [
        {
          "code": "example",
          "message": "example"
        }
      ]
    }
    

No longer supported, please use an alternative and newer version.