Описание
Создает заказ на раскрутку. В случае успешного выполнения вернет ответ с ID созданного заказа.
Пример запроса:
https://vkserfing.ru/api/campaign.add?token=a56a7e1rwr358ee0c14c0e58d992da436&link=http://vk.com/club31231231&type=vk_community&status=on
Пример запроса с указанием нескольких значений городов и семейного положения:
https://vkserfing.ru/api/campaign.add?token=a56a7e1rwr358ee0c14c0e58d992da436&link=http://vk.com/club31231231&type=vk_community&relation[]=1&relation[]=2&city[]=1&city[]=2
Пример ответа:
{
status: 'success',
data: { id: 23432 }
}Параметры
| Название | Описание |
|---|---|
| Общие параметры | |
| name | Название |
| type |
обязательный параметр
Тип задания. |
| link |
обязательный параметр
Ссылка на задание. |
| status |
обязательный параметр
Статус заказа.Может принимать следующие значения:
|
| order_id |
обязательный параметр
Идентификатор заказа в вашей системе.
Используется для предотвращения повторного создания заказа. В случае, если такой заказ уже был создан, то запрос вернёт ошибку ORDER_EXISTS Принимается любое числовое или символьное значение длиной до 36 символов. |
| project_id | ID папки |
| adult |
Материалы для взрослых (18+). Может принимать следующие значения:
|
| amount_users_limit |
обязательный параметр для всех типов заданий кроме vk_poll
Количество исполнителей.
|
| amount_users_limit_of_day |
Лимит исполнителей в сутки. Максимальные/минимальные лимиты указаны на странице https://vkserfing.ru/price |
| users_limit_random |
Варьировать количество исполнителей По умолчанию - off Допустимые значения:
|
| amount_automatic_records_limit |
Количество новых постов (лимит, определяющий сколько заданий будет создано)
|
| amount_automatic_old_records_limit |
Количество существующих публикаций, на которые будут созданы автозадания. Параметр может принимать значения от 0 до 100. Только для автоматических типов заданий |
| Специфические параметры | |
| insurance |
Страховка. При включении данной опции, в случаях санкций со стороны ВКонтакте к вашему сообществу, мы обязуемся компенсировать потраченные средства. Может принимать следующие значения:
Только для заданий с типом vk_community |
| vote_type |
Тип голосования Может принимать следующие значения:
Только для заданий с типом vk_poll |
| votes |
Номера вариантов голосования и количество голосующих Должен передаваться массив в формате HTTP Array, для упрощения пример в формате JSON:
|
| comments_type |
Тип комментариев Только для заказов с типами:
|
| comments |
Комментарии для публикации Должен передаваться массив в формате HTTP Array, для упрощения пример в формате JSON:
Только для заказов с типами:
|
| like_comment_user |
Юзернейм комментируемого пользователя, комментарий которого нужно лайкнуть Только для заданий с типом instagram_like |
| stories_to_view |
Количество историй для просмотра Только для заданий с типом instagram_view_history |
| telegram_bot_check | |
| Параметры таргетинга | |
| sex |
Пол аудитории. Может принимать следующие значения:
|
| relation |
Семейное положение. Передается в виде массива. Можно указать несколько значений Параметр доступен только для заданий |
| age_from |
Минимальный возраст исполнителя По умолчанию - 0 |
| age_to |
Максимальный возраст исполнителя По умолчанию - 999 |
| friends_from |
Минимальное
количество друзей
или
подписчиков
у исполнителя По умолчанию - 0 Параметр доступен только для заданий:
|
| friends_to |
Максимальное
количество друзей
или
подписчиков у исполнителя у исполнителя По умолчанию - 9999 Параметр доступен только для заданий:
|
| subscribes_from |
Минимальное количество подписок исполнителя По умолчанию - 0 Параметр доступен только для заданий:
|
| subscribes_to |
Максимальное количество подписок у исполнителя По умолчанию - 99999 Параметр доступен только для заданий:
|
| profile_photos_from |
Минимальное количество фотографий профиля у исполнителя По умолчанию - 0 Только для заданий |
| profile_photos_to |
Максимальное количество фотографий профиля у исполнителя По умолчанию - 999 Только для заданий |
| records_from |
Минимальное количество
записей на странице или
публикаций
исполнителя
По умолчанию - 0 Параметр доступен только для заданий:
|
| records_to |
Максимальное количество
записей на странице или
публикаций
исполнителя
По умолчанию - 99999 Параметр доступен только для заданий:
|
| reg_type |
Тип времени с момента регистрации исполнителя
По умолчанию - month Может принимать следующие значения:
|
| reg_num |
Количество месяцев/лет с момента регистрации исполнителя По умолчанию - 0 Параметр доступен только для заданий |
| country_id |
ID страны исполнителя. Моно передать в виде
HTTP массива
или строкой ID, разделенных запятой. Список ID стран можно получить методом util.getCountries Можно указать до 20 стран |
| city_id |
ID городов исполнителя. HTTP массива
или строкой ID, разделенных запятой. При передаче 2-х и более стран в параметре country_id параметр city_id не учитывается Список ID городов можно получить на util.getCities Можно указать до 50 городов |
Ошибки
| Название | Описание |
|---|---|
| NOT_AVAILABLE | Недостаточно прав для проведения операции. Возможно, вам была отключена возможность создавать заказы |
| INCORRECT_LINK | Некорректная ссылка заказа. Ссылка должна соотвествовать выбранному типу задания |
| EXIST_CAMPAIGN | Такой заказ уже существует |
| BANNED_CAMPAIGN | Такой заказ заблокирован |
| MODERATE_CAMPAIGNS | У вас есть заказы на модерации, для создания новых необходимо дождаться их рассмотрения |
| USER_THIS_CAMPAIGN_ON | У вас уже имеется такая же запущенный заказ |
| ALL_THIS_CAMPAIGN_ON | В базе всех заказов уже имеется такая же запущенный заказ |
| NOT_EXIST_COMMUNITY | Такого сообщества не существует |
| DELETED_COMMUNITY | Такого сообщества не существует или удалено |
| REQUIRED_PUBLIC_COMMUNITY | Сообщество должно быть открытым |
| REQUIRED_PHOTO_COMMUNITY | У сообщества должна быть установлена главная фотография (аватарка) |
| REQUIRED_WALL_ITEMS_COMMUNITY | В сообществе должно быть не менее 5 записей |
| PRIVATE_RESOURCE | Добавляемая страница является приватной |
| NOT_EXIST_USER | Такого пользователя не существует |
| DELETED_USER | Такого пользователя не существует либо он удален или заблокирован |
| NOT_AVAILABLE_WALL_ITEM | Чтобы создать задание, в настройках приватности страницы https://vk.com/settings?act=privacy (страницы, относящейся к указываемой записи) в параметре "Кому в интернете видна моя страница" установите значение "Всем" |
| NOT_AVAILABLE_PHOTO_ITEM | Фото не существует или скрыто настройками приватности или находится в папке "Сохраненные фотографии" |
| TELEGRAM_BOT_NOT_ADDED | Телеграм-бот не был добавлен в канал/группу (если передан параметр telegram_bot_check=1) |
| USERS_LIMIT | Достигнут лимит исполнителей для этого заказа |
| NEW_RECORDS_LIMIT | Достигнут лимит количества новых записей |
| TOO_FREQUENT | Слишком частый запрос |
| ORDER_EXISTS | Такой заказ уже создан. Возможна только при передаче параметра order_id |