GET /creatives/
Возвращает список зарегистрированных креативов.
Формат запроса
GET https://distribution.yandex.net/api/v2/creatives/
? [clid=<string>]
& [page=<integer>]
& [page_size=<integer>]
|
|
Обязательный параметр. CLID, для которого нужно вывести список созданных для него креативов. |
|
|
Номер страницы. Если параметр не указан, возращается первая страница. |
|
|
Размер страницы. Значение по умолчанию – 30. |
Общая структура ответа приведена ниже. Порядок следования элементов не гарантируется. В структуре могут присутствовать служебные параметры, которые не описаны в таблице.
Формат ответа
{
"data": {
"count": {integer},
"countItemsOnPage": {integer},
"current": {integer},
"next": {integer},
"previous": {integer},
"results": [
{
"clid": {integer},
"token": {string},
"dt_created": {string},
"dt_changed": {string},
"description": {string}
}
]
},
"result": "ok"
}
Параметры ответа
|
|
Количество креативов. |
|
|
Количество записей на странице. |
|
|
Номер текущей страницы. |
|
|
Номер следующей страницы. |
|
|
Номер предыдущей страницы. |
|
|
Информация о креативе. |
|
|
CLID, к которому относится креатив. |
|
|
Токен креатива. |
|
|
Дата создания креатива. |
|
|
Дата изменения креатива. |
|
|
Описание креатива. |
Пример для JSON
Запрос:
curl -i -H "Accept: application/json" -H "Authorization: OAuth 66..." -X GET "https://distribution.yandex.ru/api/v2/creatives/?clid=123456"
Ответ:
{
"data": {
"count": 2,
"countItemsOnPage": 30,
"current": 1,
"next": null,
"previous": null,
"results": [
{
"clid": 123456,
"token": "4CQwVszL78EMgDAwBoV",
"dt_created": "2023-08-26T18:12:15.315552+03:00",
"dt_changed": "2023-08-26T18:12:19.101429+03:00",
"description": "Test description"
},
{
"clid": 123456,
"token": "4CQwVszL78EMgDAvrAo",
"dt_created": "2023-08-26T17:19:59.515248+03:00",
"dt_changed": "2023-08-26T17:20:04.495564+03:00",
"description": "Test description 2"
}
]
},
"result": "ok"
}