有关地区的资料
方法适用于模式：FBY, FBS, Express 和 DBS.
如果您使用API-Key令牌，调用该方法时需要具备列表中可用权限之一
- inventory-and-order-processing — 订单处理和商品核算
- inventory-and-order-processing:read-only — 查看订单信息
- pricing — 价格管理
- pricing:read-only — 查看价格
- offers-and-cards-management — 商品和卡片管理
- offers-and-cards-management:read-only — 查看商品和卡片
- promotion — 商品推广
- promotion:read-only — 查看商品推广信息
- finance-and-accounting — 查看财务信息和报告
- communication — 与买家沟通
- settings-management — 店铺设置
- supplies-management:read-only — 获取有关FBY应用程序的信息
- all-methods — 全面管理账户
- all-methods:read-only — 查看所有数据
返回有关区域的信息。
对于方法 GET v2/regions, GET v2/regions/{regionId} 和 GET v2/regions/{regionId}/children 组资源限制生效。 该限制是对区域总数施加的，使用这些方法请求哪些信息（不超过100,000个区域）。
白天可以完成的对资源的请求量取决于区域的总数。
| ⚙️ 限制: 每小时50,000次请求 |
|---|
Request
GET
https://api.partner.market.yandex.ru/v2/regions/{regionId}
Path parameters
|
Name |
Description |
|
regionId* |
Type: integer<int64> 区域的ID。 您可以使用请求获取区域ID GET v2/regions. |
Responses
200 OK
找到的区域。
Body
application/json
{
"regions": [
{
"id": 0,
"name": "string",
"type": "OTHER"
}
],
"paging": {
"nextPageToken": "string"
}
}
|
Name |
Description |
||
|
regions* |
Type: object[] 的输送区域。 |
||
|
paging |
Type: object
下一页的ID。 |
401 Unauthorized
请求中未指定授权数据。 有关错误的更多信息
Body
application/json
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
|
Name |
Description |
|
errors |
Type: object[] 错误列表。 Min items: |
|
status |
Type: string 响应的类型。 可能的值:
Enum: |
403 Forbidden
授权数据不正确或禁止访问资源。 有关错误的更多信息
Body
application/json
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
|
Name |
Description |
|
errors |
Type: object[] 错误列表。 Min items: |
|
status |
Type: string 响应的类型。 可能的值:
Enum: |
404 Not Found
找不到请求的资源。 有关错误的更多信息
Body
application/json
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
|
Name |
Description |
|
errors |
Type: object[] 错误列表。 Min items: |
|
status |
Type: string 响应的类型。 可能的值:
Enum: |
420 Method Failure
已超出资源访问限制。 有关错误的更多信息
Body
application/json
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
|
Name |
Description |
|
errors |
Type: object[] 错误列表。 Min items: |
|
status |
Type: string 响应的类型。 可能的值:
Enum: |
500 Internal Server Error
市场的内部错误。 有关错误的更多信息
Body
application/json
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
|
Name |
Description |
|
errors |
Type: object[] 错误列表。 Min items: |
|
status |
Type: string 响应的类型。 可能的值:
Enum: |
No longer supported, please use an alternative and newer version.