Возобновление показа предложений

Описание

DELETE /hidden-offers

Возобновляет показ предложений магазина в поиске по товарам, скрытых с помощью метода POST /hidden-offers. Если предложение не отображается по другой причине (например, удалено из фида или не соответствует требованиям поиска по товарам), оно не начнет отображаться.

В теле запроса можно передать от одного до 500 предложений.

Формат запроса

DELETE https://yandex.ru/products/api/ext/partner/hidden-offers

Параметры

Пример структуры тела запроса:

{
  "hiddenOffers":
  [
    {
      "feedId": {int64},
      "offerId": "{string}"
    },
    ...
  ]
}

Параметр

Тип

Значение

hiddenOffers

Список скрытых предложений.

В теле запроса можно передать от одного до 500 предложений.

Обязательный параметр.

Параметры, вложенные в hiddenOffers

feedId

Int64

Идентификатор фида.

Обязательный параметр.

offerId

String

Идентификатор предложения из фида.

Максимальная длина — 50 символов.

Обязательный параметр.

Формат ответа

Пример структуры ответа. Порядок следования параметров не гарантируется.

{
  "errors":
  [
    {
      "code": "{enum}",
      "message": "{string}"
    },
    ...
  ],
  "status": "{enum}"
}

Параметр

Тип

Значение

Параметры, вложенные в response

errors

Список ошибок при выполнении запроса.

Выводится, если status="ERROR".

status

Enum

Статус выполнения запроса.

Возможные значения:

  • OK — запрос выполнен успешно.
  • ERROR — произошла ошибка.

Параметры, вложенные в errors

code

Enum

Код ошибки.

Возможные значения:

  • DUPLICATE_OFFER — в запросе переданы два или более товаров с одинаковыми значениями параметров feedId и offerId.
  • INVALID_FEED_ID — в теле запроса в параметре feedId передан идентификатор фида, который не существует.
  • INVALID_OFFER_ID — в теле запроса в параметре offerId передан пустой идентификатор предложения или его значение превышает 50 символов.
  • REQUEST_LIMIT_EXCEEDED — в теле запроса передано больше 500 предложений.

message

String

Описание ошибки.

Описание ошибок

В случае ошибки сервер возвращает HTTP-код ответа и краткое описание ошибки.

Ограничения

Допускается до 50 000 скрытий и возобновлений показов предложений в минуту.

Примеры

Пример запроса:

curl -i -X DELETE 'https://yandex.ru/products/api/ext/partner/hidden-offers'

Тело DELETE-запроса:

-d '{
  "hiddenOffers":
  [
    {
      "feedId": 67891,
      "offerId": "101Ab12313C"
    }
  ]
}'

Пример ответа:

HTTP/1.1 200 OK
Date: Fri, 11 Aug 2017 00:42:42 GMT
Content-Type: application/json;charset=utf-8
...

{
  "status": "OK"
}