MoveCollections#

Бета-версия

Функциональность находится в режиме бета-версии. Функции могут быть изменены, а также могут работать нестабильно.

Метод предназначен для изменения порядка (перемещения) коллекций в списке каталога.

Запрос#

Для перемещения коллекций требуется выполнить запрос по адресу:

POST

{{baseUrl}}/waInstance{{idInstance}}/moveCollections/{{apiTokenInstance}}

Для получения параметров запроса idInstance и apiTokenInstance обратитесь к разделу Перед началом работы.

Параметры запроса#

Параметр	Тип	Обязательный	Описание
collections	array of objects	Да	Массив объектов с информацией о перемещении каждой коллекции

Объект перемещения коллекции:

Поле	Тип	Описание
collectionId	string	Уникальный идентификатор перемещаемой коллекции
fromIndex	integer	Текущий индекс коллекции (начинается с 0)
toIndex	integer	Новый индекс коллекции (начинается с 0)

Пример тела запроса#

{
  "collections": [
    { "collectionId": "2205593430194788", "fromIndex": 0, "toIndex": 1 },
    { "collectionId": "25790827003925602", "fromIndex": 1, "toIndex": 0 }
  ]
}

Ответ#

Поля ответа#

Поле	Тип	Описание
moved	boolean	Возвращает true, если перемещение выполнено успешно
collections	array	Массив объектов с подтверждением перемещения для каждой коллекции

Пример тела ответа#

{
    "moved": true,
    "collections": [
        {
            "collectionId": "2205593430194788",
            "fromIndex": 0,
            "toIndex": 1
        },
        {
            "collectionId": "25790827003925602",
            "fromIndex": 1,
            "toIndex": 0
        }
    ]
}

Ошибки MoveCollections#

Перечень общих для всех методов ошибок смотрите в разделе Стандартные ошибки

Примеры кода#

PythoncURL

import requests

url = "{{apiUrl}}/waInstance{{idInstance}}/moveCollections/{{apiTokenInstance}}"

payload = {
"collections": [
    {"collectionId": "2205593430194788", "fromIndex": 0, "toIndex": 1},
    {"collectionId": "25790827003925602", "fromIndex": 1, "toIndex": 0}
]
}
headers = {
    'Content-Type': 'application/json'
}

response = requests.post(url, json=payload, headers=headers)

print(response.text.encode('utf8'))

curl --location '{{apiUrl}}/waInstance{{idInstance}}/moveCollections/{{apiTokenInstance}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "collections": [
        {"collectionId": "2205593430194788", "fromIndex": 0, "toIndex": 1},
        {"collectionId": "25790827003925602", "fromIndex": 1, "toIndex": 0}
    ]
}'

Внимание

Организация Meta, а также её продукты Instagram и Facebook, на которые мы ссылаемся в этой статье, признаны экстремистскими на территории РФ.
WhatsApp* принадлежит компании Meta Platforms Inc., деятельность которой признана экстремистской и запрещена на территории Российской Федерации. На основании решения Тверского районного суда г.Москвы от 21.03.2022 и требований ст. 10 ФЗ-114 в отношении компании Meta Platforms Inc.