--- metadata: - name: generator content: Diplodoc Platform v5.66.1 alternate: - https://yandex.com/support/market-distr/ru/api/reference/get-creatives.md - href: https://yandex.com/support/market-distr/ru/api/reference/get-creatives.md type: text/markdown title: Markdown version - href: https://yandex.com/support/market-distr/ru/llms.txt?revision=r22075821 rel: describedby keywords: GET /marking --- > **Documentation Index:** Fetch the complete configuration index at https://yandex.com/support/market-distr/ru/llms.txt?revision=r22075821 # Получение креативов ## Описание {#description} ```no-highlight GET /marking ``` Возвращает список зарегистрированных креативов. URL ресурса: ```no-highlight https://api.content.market.yandex.ru/v3/affiliate/marking/ ``` ## Входные данные {#input} #| || **Параметр** | **Тип** | **Значение** | **Обязательный** || || `clid` | String | Ваш идентификатор в реферальной программе. | да || || `page` | Int64 | Номер страницы. Если параметр не указан, возращается первая страница. | нет || || `page_size` | Int64 | Размер страницы. Значение по умолчанию – 30. | нет || |# Общая структура ответа приведена ниже. Порядок следования элементов не гарантируется. В структуре могут присутствовать служебные параметры, которые не описаны в таблице. ## Выходные данные {#output} ```json { "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" } ``` Описание параметров: #| || **Параметр** | **Тип** | **Значение** || || `count` | Integer | Количество креативов. || || `countItemsOnPage` | Integer | Количество записей на странице. || || `current` | Integer | Номер текущей страницы. || || `next` | Integer | Номер следующей страницы. Если следующей страницы нет — `null`. || || `previous` | Integer | Номер предыдущей страницы. Если предыдущей страницы нет — `null`. || || `clid` | Integer | CLID, к которому относится креатив. || || `token` | String | Токен креатива. || || `dt_created` | String | Дата создания креатива в формате ISO 8601. || || `dt_changed` | String | Дата изменения креатива в формате ISO 8601. || || `description` | String | Описание креатива. || || `result` | String | Статус выполнения запроса. Всегда возвращается `ok`. || |# ## Примеры {#examples} Запрос: ```bash curl -i -H "Accept: application/json" -H "Authorization: OAuth 66..." -X GET "https://api.content.market.yandex.ru/v3/affiliate/marking/?clid=123456"' ``` Ответ: ```json { "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" } ``` [*status]: Статус заказа: - `NEW` — в обработке: покупатель оформил заказ, но пока не получил его. - `ON_HOLD` — ждет подтверждения: покупатель получил заказ, но со дня получения не прошло 14 дней. - `APPROVED` — подтвержден: прошло две недели со дня получения заказа. - `CANCELLED` — вознаграждение за заказ не выплачивается. Информация о причинах отмены указана в параметре `additionalInfo`. [*enum]: Код причины, по которой вознаграждение за заказ не выплачивается: - `ABUSE` — нарушение связано с поведением покупателя: - Превысил количество покупок конкретного товара или группы товаров из одной категории в 2,5 раза. Рассчитывается относительно средних показателей сервиса за день, неделю или месяц. - Использовал купоны, которые принадлежат одному покупателю, с разных аккаунтов. - Оформил заказ с шести и более разных аккаунтов, которые принадлежат одному покупателю. - `ALL_ITEMS_RETURNED` — покупатель создал заявку на возврат в течение 14 дней после получения заказа, даже если потом не вернул по ней товары. Если он возвращает только часть товаров из заказа, за остальные вознаграждение будет начислено. - `BANNED_REGIONS` — покупатель оформил заказ на Маркете с доставкой в регион, которого нет в списке. {% cut "Список регионов" %} - Москва и Московская область - Санкт-Петербург и Ленинградская область - Воронежская область - Краснодарский край - Красноярский край - Нижегородская область - Новосибирская область - Пермский край - Республика Башкортостан - Республика Татарстан - Ростовская область - Самарская область - Свердловская область - Челябинская область {% endcut %} - `BANNED_SOURCE` — покупатель перешел с [запрещенного источника трафика](https://yandex.ru/support/market-distr/ru/rules#not-paid) и оформил заказ на Маркете. - `BUYER_CANCEL` — покупатель отменил заказ. - `FULL_CART_COUPON` — покупатель сначала добавил товары в корзину на Маркете и затем перешел на агрегатор купонов или промокодов, чтобы получить скидку на свой заказ. - `MARKET_CANCEL` — Маркет отменил заказ из-за технической ошибки. - `ORDER_CREATION_EXPIRED` — покупатель не оплатил заказ. - `ORDER_NOT_REPURCHASED` — покупатель не забрал заказ. - `PARTNER_PROMO_CODE` — покупатель применил промокод другого партнера. - `REFERRAL_PROMOCODE` — покупатель применил реферальный промокод. - `SELLER_CANCEL` — магазин отменил заказ. - `VIOLATION_TERMS_OF_USE` — покупатель нарушил [правила использования сервиса](https://yandex.ru/legal/market_termsofuse/). Подробнее см. в разделе [Вознаграждение за заказы на Маркете](https://yandex.ru/support/market-distr/ru/terms) Справки реферальной программы. Возвращается, только если параметр `status` имеет значение `CANCELLED`. Параметр возвращается только для формата XML. Для формата JSON возвращается код в виде строки. [*cart]: Общая стоимость всех единиц товара в заказе. Возвращается, только если входной параметр `total` не указан или в нем указано значение `false`. [*cart-orders]: Сумма заказа в рублях. [*result]: Ответ. Параметр возвращается только для формата XML. [*orders]: Список заказов. [*order]: Информация о заказе. Параметр возвращается только для формата XML. [*clid]: Ваш идентификатор в реферальной программе. [*vid]: Дополнительный идентификатор инструмента монетизации, с которым покупатель взаимодействовал перед оформлением заказа на Маркете. [*order-id]: Номер заказа. [*date-created]: Дата и время создания заказа. Формат даты и времени: [ISO 8601](https://ru.wikipedia.org/wiki/ISO_8601). Например, `2017-11-21T00:00:00`. Часовой пояс — UTC+03:00 (Москва). [*date-updated]: Дата и время последнего изменения статуса заказа. Формат даты и времени: [ISO 8601](https://ru.wikipedia.org/wiki/ISO_8601). Например, `2017-11-21T00:00:00`. Часовой пояс — UTC+03:00 (Москва). [*additional-info]: Список причин, по которым вознаграждение за заказ не выплачивается. Возвращается, только если параметр `status` имеет значение `CANCELLED`. [*payment]: Сумма вознаграждения за заказ в рублях. [*payment-orders]: Общее вознаграждение за все единицы товара в заказе. Возвращается, только если входной параметр `total` не указан или в нем указано значение `false`. [*tariff]: Поле больше не поддерживается. [*items-orders]: Список товаров в заказе. Возвращается, только если входной параметр `total` не указан или в нем указано значение `false`. [*item-orders]: Информация о товаре. Возвращается, только если входной параметр `total` не указан или в нем указано значение `false`. Параметр возвращается только для формата XML. [*item-id-orders]: Номер товара в заказе. Нумерация начинается с `0`. Возвращается, только если входной параметр `total` не указан или в нем указано значение `false`. [*item-count-orders]: Количество единиц товара в заказе, за которые должно быть выплачено вознаграждение. За товары, которые покупатель начал возвращать в течение двух недель со дня получения, вознаграждение не выплачивается. Возвращается, только если входной параметр `total` не указан или в нем указано значение `false`. [*tariff-name]: Поле больше не поддерживается. [*tariff-rate]: Доля от общей стоимости всех единиц товара в заказе, выплачиваемая как вознаграждение. Возвращается, только если входной параметр `total` не указан или в нем указано значение `false`. [*promo-order]: Реферальный промокод, который покупатель указал в заказе.