Удалить продукты
Описание
Удалить продукты в маркете. Метод поддерживает как одиночное удаление, так и массовое удаление нескольких продуктов за один запрос.
Для удаления необходимо использовать токен, для которого назначена роль с соответствующими правилами доступа.
URL-адрес
Метод: POST
https://example.com/api/v1.1/market/products/delete
Параметры запроса
| Параметр | Тип | Пример | Обязательный | Описание |
|---|---|---|---|---|
| token | string | "abcdefghijklmnqrstuvwxyz" | Да | API-токен |
| ids | array of integers | [1, 2, 3] | Нет, если передается external_ids | Массив внутренних идентификаторов продуктов |
| external_ids | array of strings | ["product_1", "product_2"] | Нет, если передается ids | Массив внешних идентификаторов продуктов |
Пример запроса
- Одиночный JSON
- Батч JSON
- Одиночный XML
- Батч XML
Идентификация по парметру: "ids":
{
"token": "abcdefghijklmnqrstuvwxyz",
"ids": [1]
}
Идентификация по парметру: "external_ids":
{
"token": "abcdefghijklmnqrstuvwxyz",
"external_ids": ["sku_123"]
}
{
"token": "abcdefghijklmnqrstuvwxyz",
"ids": [1, 2],
"external_ids": ["sku_3"]
}
Идентификация по парметру: "ids":
<xml>
<token>abcdefghijklmnqrstuvwxyz</token>
<ids>1</ids>
</xml>
Идентификация по парметру: "external_ids":
<xml>
<token>abcdefghijklmnqrstuvwxyz</token>
<external_ids>product_123</external_ids>
</xml>
<xml>
<token>abcdefghijklmnqrstuvwxyz</token>
<ids>1</ids>
<ids>2</ids>
<external_ids>product_3</external_ids>
</xml>
Пример ответа
- JSON
- XML
{
"deleted_count": 2,
"error": 0,
"error_text": ""
}
<xml>
<deleted_count>2</deleted_count>
<error>0</error>
<error_text></error_text>
</xml>
Возвращаемые параметры
| Параметр | Тип | Описание |
|---|---|---|
| deleted_count | int | Количество фактически удаленных продуктов |
| error | int | Код ошибки |
| error_text | string | Текст ошибки |