Отчет «Цены на рынке»
Запускает генерацию отчета «Цены на рынке».
Формат отчета
Отчет доступен в формате FILE — электронная таблица.
Узнать статус генерации и получить ссылку на готовый отчет можно с помощью запроса GET reports/info/{reportId}.
| ⚙️ Лимит: 100 запросов в час |
|---|
Request
POST
https://api.partner.market.yandex.ru/reports/prices/generate
Query parameters
|
Name |
Type |
Description |
|
format |
Формат отчета. |
ReportFormatType
Формат отчета:
FILE— файл с электронной таблицей.CSV— ZIP-архив с CSV-файлами на каждый лист отчета. Работает только для отчетов, где явно указана поддержка формата CSV.
|
Type |
Description |
|
Enum: |
Body
{
"businessId": 0,
"campaignId": 0,
"categoryIds": [
0
],
"creationDateFrom": "string",
"creationDateTo": "string"
}
|
Name |
Type |
Description |
|
businessId |
integer<int64> |
Идентификатор бизнеса. В большинстве случаев обязателен. Не указывается, если задан |
|
campaignId |
integer<int64> |
Идентификатор кампании. Как правило, не используется. Передавайте только если в кабинете есть магазины с уникальными ценами и вы хотите получить отчет для них. В этом случае передавать |
|
categoryIds |
integer<int64>[] |
Фильтр по категориям на Маркете. |
|
creationDateFrom |
string<date> |
Фильтр по времени появления предложения — начало периода. Формат даты: |
|
creationDateTo |
string<date> |
Фильтр по времени появления предложения — окончание периода. Формат даты: |
Responses
200 OK
В ответ приходит идентификатор, который позволяет узнавать статус генерации и скачать готовый отчет.
Body
{
"status": "OK",
"result": {
"reportId": "string",
"estimatedGenerationTime": 0
}
}
|
Name |
Type |
Description |
|
status |
Тип ответа. |
|
|
result |
Идентификатор, который понадобится для отслеживания статуса генерации и получения готового отчета. |
ApiResponseStatusType
Тип ответа.
|
Type |
Description |
|
Enum: |
GenerateReportDTO
Идентификатор, который понадобится для отслеживания статуса генерации и получения готового отчета.
|
Name |
Type |
Description |
|
reportId* |
string |
Идентификатор, который понадобится для отслеживания статуса генерации и получения готового отчета. |
|
estimatedGenerationTime* |
integer<int64> |
Ожидаемая продолжительность генерации в миллисекундах. |
400 Bad Request
Запрос содержит неправильные данные.
Body
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
|
Name |
Type |
Description |
|
status |
Тип ответа. |
|
|
errors |
Список ошибок. |
ApiErrorDTO
Общий формат ошибки.
|
Name |
Type |
Description |
|
code* |
string |
Код ошибки. |
|
message |
string |
Описание ошибки. |
401 Unauthorized
В запросе не указаны данные для авторизации.
Body
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
|
Name |
Type |
Description |
|
status |
Тип ответа. |
|
|
errors |
Список ошибок. |
403 Forbidden
Данные для авторизации неверны или доступ к ресурсу запрещен.
Body
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
|
Name |
Type |
Description |
|
status |
Тип ответа. |
|
|
errors |
Список ошибок. |
420 Method Failure
Превышено ограничение на доступ к ресурсу.
Body
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
|
Name |
Type |
Description |
|
status |
Тип ответа. |
|
|
errors |
Список ошибок. |
500 Internal Server Error
Внутренняя ошибка сервера.
Body
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
|
Name |
Type |
Description |
|
status |
Тип ответа. |
|
|
errors |
Список ошибок. |