Описание
Создает заказ на раскрутку. В случае успешного выполнения вернет ответ с 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 |
Проверка ботом позволяет максимально точно определять, подписался ли исполнитель на канал/группу. Если опция отключена, мы используем иные алгоритмы проверки выполнения задания, которые могут быть недостаточно точными.
Для включения опции необходимо добавить нашего бота StatisticsChannelsBot в список администраторов канала/группы. Чтобы бот был добавлен, достаточно установить ему минимальное право – Добавление подписчиков (возможно другое название этого пункта – “Добавление пользователей”, это зависит от платформы, на которой установлен Telegram). Это безопасно, так как боту не нужно иметь никаких прав, кроме минимального. Включение опции позволяет максимально точно отслеживать, подписался ли исполнитель на канал/группу. Может принимать следующие значения:
Только для заданий с типом telegram_follower |
| Параметры таргетинга | |
| 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 | Фото не существует или скрыто настройками приватности или находится в папке "Сохраненные фотографии" |
| USERS_LIMIT | Достигнут лимит исполнителей для этого заказа |
| NEW_RECORDS_LIMIT | Достигнут лимит количества новых записей |
| TOO_FREQUENT | Слишком частый запрос |
| ORDER_EXISTS | Такой заказ уже создан. Возможна только при передаче параметра order_id |