Изменения в документации

Из документации удалена информация, связанная с оплатой за клики, в том числе устаревший метод GET /stats/clicks.

Ограничение запросов снизилось до 5 запросов в секунду.

Добавлен запрос GET /promo/catalog — получение списка действующих на Маркете акций.

Для выходного параметра fields запросов GET /search и GET /categories/{categoryId}/search добавлено значение MODEL_SPECIFICATION. Оно передает основные характеристики товара в параметре specifications.

Для выходного параметра additionalInfo / info запросов GET /order и GET /orders добавлены новые причины, по которым не выплачивается вознаграждение за заказ.

Для выходного параметра orders / order запросов GET /order и GET /orders добавлен параметр promoсode. Он возвращает партнерский промокод, который покупатель указал в заказе.

Для выходного параметра additionalInfo / info запросов GET /order и GET /orders добавлены причины, по которым не выплачивается вознаграждение за заказ.

Ограничение запросов увеличилось до 20 запросов в секунду.

Добавлен запрос GET /order — отчет по одному заказу.

На Маркете больше нет раздела «Покупки». Товары, которые ранее размещались в нем, теперь продаются прямо на Маркете. Поэтому теперь:

• Запрос GET /search возвращает список товаров с покупкой на Маркете. Товары ищутся во всем сервисе.

• Для запросов GET /categories/{categoryId}/search, GET /models/{modelId}/offers и GET /categories/{categoryId}/hot-offers выбирайте категорию или товар в каталоге Маркета — в нем собраны товары и категории, которые ранее размещались в разделе «Покупки».

• Запрос GET /partner/link/create возвращает партнерскую ссылку на любую страницу Маркета, кроме раздела «Покупки». Если вы ранее использовали ссылки на этот раздел, они будут автоматически перенаправлять пользователя на аналогичную страницу на Маркете.

  При этом в выходном параметре searchType запроса GET /partner/link/create больше не будут возвращаться значения для страниц раздела «Покупки» на Маркете.

Для выходного параметра additionalInfo / info запроса GET /orders добавлено значение FULL_CART_COUPON — пользователь сначала добавил товары в корзину на Маркете и затем перешел на агрегатор купонов или промокодов, чтобы получить скидку на свой заказ. Такие агрегаторы являются запрещенными источниками трафика.

В запросе GET /search добавлен входной параметр exact-match — точный поиск товаров.

Значения OVER_LIMIT и UNDER_MINIMUM_PAYOUT_LIMIT возвращаются в выходном параметре additionalInfo / info запроса GET /orders только для заказов, оформленных до 18 мая 2021 года включительно.

Для выходного параметра additionalInfo / info запроса GET /orders добавлено значение PARTNER_PROMO_CODE — пользователь перешел на Маркет с вашей площадки, но оформил заказ со специальным промокодом другого партнера (такие промокоды выдает партнерская сеть).

Добавлен запрос GET /partner/link/create — создание партнерских ссылок Маркета.

Если покупатель создал заявку на возврат в течение 14 дней после получения заказа, даже если потом не вернул по ней товары. Если он возвращает только часть товаров из заказа, за остальные вознаграждение будет начислено., в выходном параметре status запроса GET /orders возвращается значение CANCELLED, а в выходном параметре additionalInfo / info — значение ALL_ITEMS_RETURNED.

Во входном параметре text запроса GET /search теперь можно передавать:

• штрихкод товара в формате EAN‑13, EAN‑8, UPC‑A, UPC‑E или Code 128;

• ISBN, если нужно найти книжное издание.

В запросах GET /search, GET /categories/{categoryId}/search, GET /categories/{categoryId}/hot-offers, GET /models/{modelId}/offers добавлены входные параметры:

• clid — идентификатор площадки.

• vid — дополнительный идентификатор для ссылок.

Беру стал частью Яндекс.Маркета.

Документ переименован в «API партнерской сети Маркета».

Изменены URI и URL ресурсов. Теперь в них не используется часть «beru» или «market».

https://api.content.market.yandex.ru/v3/affiliate/search

https://api.content.market.yandex.ru/v3/affiliate/categories/{categoryId}/search

https://api.content.market.yandex.ru/v3/affiliate/categories/{categoryId}/hot-offers

https://api.content.market.yandex.ru/v3/affiliate/models/{modelId}/offers

https://api.content.market.yandex.ru/v3/affiliate/stats/clicks

https://api.content.market.yandex.ru/v3/affiliate/orders

https://api.content.market.yandex.ru/v3/affiliate/search

https://api.content.market.yandex.ru/v3/affiliate/categories/{categoryId}/search

https://api.content.market.yandex.ru/v3/affiliate/categories/{categoryId}/hot-offers

https://api.content.market.yandex.ru/v3/affiliate/models/{modelId}/offers

https://api.content.market.yandex.ru/v3/affiliate/stats/clicks

https://api.content.market.yandex.ru/v3/affiliate/orders

Документ переименован в «API партнерской сети Маркета и Беру».

Добавлен запрос GET /market/stats/clicks (метод устарел) — отчет по оплачиваемым кликам Маркета.

Изменены URI ресурсов у запросов к Беру (их URL остаются прежними). Новые URI:

• GET /beru/search

• GET /beru/categories/{categoryId}/search

• GET /beru/categories/{categoryId}/hot-offers

• GET /beru/models/{modelId}/offers

• GET /beru/orders

В запросе GET /models/{modelId}/offers:

• Для входного параметра fields добавлено значение OFFER_CHECKOUT_LINK, позволяющее получить в выходных данных URL страниц Беру, на которых пользователи могут оформить заказы с вариантами товара.

• Добавлен входной параметр touch — должна ли страница оформления заказа быть адаптирована для мобильных устройств.
• Добавлен выходной параметр checkoutUrl — URL страницы Беру, на которой пользователь может оформить заказ с вариантом товара.

Добавлен запрос GET /orders — отчет по заказам.

Добавлен запрос GET /categories/{categoryId}/hot-offers — выгодные товары в категории.

Добавлен запрос GET /categories/{categoryId}/search — товары в категории.

Добавлены запросы:

• GET /search — текстовый поиск товаров.
• GET /models/{modelId}/offers — варианты товара.