API

API (программный интерфейс приложения) позволяет организовать интеграцию вашего собственного приложения с сервисом Впостер.

Ключ доступа

Ключ доступа можно получить в кабинете сервиса в разделе "Разработчикам" или по ссылке.

Документация

Получить информацию о кабинете

get

Возвращает информацию о кабинете.

Authorizations

AuthorizationstringRequired

Bearer‑токен, полученный через vposter.ru/dev. Передаётся в заголовке запроса: Authorization: Bearer <access_token>

Responses

200

Успешный ответ. Возвращается объект с полем response.items.

application/json

400

Ошибка запроса. Возможные причины:

Токен не передан в заголовке Authorization
Отсутствуют обязательные заголовки
Некорректный формат запроса

application/json

401

Неавторизованный доступ. Возможные причины:

Токен недействителен или просрочен

application/json

500

Внутренняя ошибка сервера. Не удалось выполнить запрос.

application/json

get/v3/method/users.getMe

GET /api/v3/method/users.getMe HTTP/1.1
Host: vposter.ru
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "response": {
    "items": [
      {
        "id": 12345678,
        "login": "",
        "first_name": "Иван",
        "last_name": "Иванов",
        "photo": "https://pp.vkuserphoto.ru/s/v1/ig2/...",
        "balance": "600.87",
        "tariff": 25,
        "tariff_update": "2026-03-10T22:22:19+03:00",
        "paid_access": 1,
        "referall": 0,
        "registration_date": "2020-01-01T13:00:00+03:00",
        "date_activity": "2026-03-10T21:09:26+03:00",
        "timezone": "GMT-3",
        "email": "example@mail.ru",
        "email_status": 1,
        "phone": "+79999999999",
        "2fa": 0
      }
    ]
  }
}

Получить список страниц для отложенного постинга

get

Возвращает перечень доступных страниц и групп, на которые разрешено публиковать контент.

Authorizations

AuthorizationstringRequired

Bearer‑токен, полученный через vposter.ru/dev. Передаётся в заголовке запроса: Authorization: Bearer <access_token>

Responses

200

Успешный ответ. Возвращается объект с полем response, содержащим:

count — общее количество доступных страниц/групп;
items — массив объектов с данными каждой страницы/группы.

application/json

400

Ошибка запроса. Возможные причины:

Токен не передан в заголовке Authorization
Отсутствуют обязательные заголовки
Некорректный формат запроса

application/json

401

Неавторизованный доступ. Возможные причины:

Токен недействителен или просрочен

application/json

500

Внутренняя ошибка сервера. Не удалось выполнить запрос.

application/json

get/v3/method/groups.getMy

GET /api/v3/method/groups.getMy HTTP/1.1
Host: vposter.ru
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "response": {
    "count": 7,
    "items": [
      {
        "fb": [
          {
            "name": "Моя группа в Facebook",
            "photo": "https://scontent-lga3-1.xx.fbcdn.net/v/t39.30808-1/257712996_10945345155821...",
            "id": 123456,
            "type_social": "fb",
            "posts": 1,
            "stories": 0
          }
        ],
        "ig_business": [
          {
            "name": "Мой аккаунт Instagram",
            "photo": "https://scontent-lga3-3.xx.fbcdn.net/v/t51.2885-15/238374209_82112946193...",
            "id": 123456,
            "type_social": "ig_business",
            "posts": 1,
            "stories": 1
          }
        ],
        "max": [
          {
            "name": "Мой канал в Max",
            "photo": "https://i.oneme.ru/i?r=BTEFHNxXjmuR0N2Fir9S...",
            "id": "123456",
            "type_social": "max",
            "posts": 1,
            "stories": 0
          }
        ],
        "ok": [
          {
            "name": "Моя группа в Одноклассниках",
            "photo": "https://i.okcdn.ru/i?r=B1tAm_VFBkioSGBqh1I9y1hD9ohkVdMB2tMNqI...",
            "id": "123456",
            "type_social": "ok",
            "posts": 1,
            "stories": 1
          }
        ],
        "rutube": [
          {
            "name": "Мой канал в Rutube",
            "photo": "https://static.rutubelist.ru/static/...",
            "id": 123456,
            "type_social": "rutube",
            "posts": 1,
            "stories": 0
          }
        ],
        "tg": [
          {
            "name": "Мой канал в Telegram",
            "photo": "https://pp.vkuserphoto.ru/s/v1/ig2/qb3BF7WXvWYN5VY...",
            "id": "123456",
            "type_social": "tg",
            "posts": 1,
            "stories": 0
          }
        ],
        "vk": [
          {
            "name": "Моя группа ВКонтакте",
            "photo": "https://pp.vkuserphoto.ru/s/v1/ig2/trWmLifY0iCMeIn7zTkhU...",
            "id": 123456,
            "type_social": "vk",
            "posts": 1,
            "stories": 0
          }
        ]
      }
    ]
  }
}

Загрузить файл на сервер

post

Загружает изображение, видео или документ на сервер для последующего использования в постах. После успешной загрузки возвращается JSON, который можно использовать в поле attachments_json при создании поста. Передавать нужно массив с вложениями.

Authorizations

AuthorizationstringRequired

Bearer‑токен, полученный через vposter.ru/dev. Передаётся в заголовке запроса: Authorization: Bearer <access_token>

Body

filestring · binaryRequired

Обязательный. Файл для загрузки (изображение, видео или документ).

Поддерживаемые форматы:

Изображения: JPG, JPEG, PNG, GIF, WEBP
Видео: MP4, AVI, MOV, MKV, WEBM
Документы: PDF, DOC, DOCX, XLS, XLSX, PPT, PPTX, TXT

Example: файл.jpg

id_groupstringRequired

Обязательный. ID страницы или группы, к которой будет привязан файл. Получается через метод /v3/method/groups.getMy.

Example: 123456

typestring · enumRequired

Обязательный. Тип загружаемого файла:

image — изображение
video — видео
file — документ

Example: imagePossible values:

Responses

200

Файл успешно загружен. Возвращается объект с полем response.attachments, содержащим массив вложения photo, video или doc. У каждого вложения могут быть свои параметры.

application/json

codestring · enumOptional

Статус ответа

Example: successPossible values:

400

Некорректный запрос. Возможные причины:

Токен не передан в заголовке Authorization
Не передан файл
Не указан id_group
Не указан тип файла
Неподдерживаемый формат файла
Превышен максимальный размер файла

application/json

401

Неавторизованный доступ. Возможные причины:

Токен недействителен или просрочен

application/json

402

Доступ запрещен. Возможные причины:

Недостаточно средств на балансе кабинета.

application/json

403

Доступ запрещен. Возможные причины:

Нет прав для загрузки файлов в указанную группу
Исчерпан лимит загрузок
Не включен "Платный доступ" в личном кабинете

application/json

413

Файл слишком большой. Превышен максимальный допустимый размер файла.

Текущие лимиты для фото:

максимальный размер фото — 10 МБ.

Текущие лимиты для документа:

максимальный размер файла — 100 МБ.

Текущие лимиты для видео:

ВКонтакте: максимальный размер видеозаписи — 100 МБ.
Одноклассники: максимальный размер видеозаписи — 50 МБ.
Telegram: максимальный размер видеозаписи или всех видеозаписей в посте — 50 МБ.
Facebook: максимальный размер видеозаписи — 50 МБ.
Rutube: максимальный размер видеозаписи — 100 МБ.
Max: максимальный размер видеозаписи — 100 МБ.

application/json

415

Неподдерживаемый тип файла. Формат файла не поддерживается для загрузки.

application/json

500

Внутренняя ошибка сервера. Не удалось загрузить файл.

application/json

post/v3/method/uploads.uploadFile

POST /api/v3/method/uploads.uploadFile HTTP/1.1
Host: vposter.ru
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: multipart/form-data
Accept: */*
Content-Length: 58

{
  "file": "файл.jpg",
  "id_group": "123456",
  "type": "image"
}

{
  "code": "success",
  "response": {
    "attachments": [
      {
        "id": 457749080,
        "type": "photo",
        "preview": "https://pp.vkuserphoto.ru/s/v1/ig2/SIXJehNSqRY1nyfc7s-fB9-FmQ8LCWaVl-vN0FGIDulCNpQSt_aF-20Rki6dVPsL02v0hWR4b6p5OC6DXtNhZNi9.jpg?quality=95&as=32x57,48x85,72x128,108x192,160x284,240x427,360x640,480x853,540x960,640x1138,720x1280,1080x1920,1280x2276,1440x2560&from=bu&cs=640x0",
        "original": "https://pp.vkuserphoto.ru/s/v1/ig2/SIXJehNSqRY1nyfc7s-fB9-FmQ8LCWaVl-vN0FGIDulCNpQSt_aF-20Rki6dVPsL02v0hWR4b6p5OC6DXtNhZNi9.jpg?quality=95&as=32x57,48x85,72x128,108x192,160x284,240x427,360x640,480x853,540x960,640x1138,720x1280,1080x1920,1280x2276,1440x2560&from=bu",
        "owner_id": 116945277,
        "access_key": "74781521bc8879f57c"
      }
    ]
  }
}

Получить список запланированных постов

get

Возвращает перечень запланированных постов пользователя с возможностью фильтрации, поиска и пагинации.

Authorizations

AuthorizationstringRequired

Bearer‑токен, полученный через vposter.ru/dev. Передаётся в заголовке запроса: Authorization: Bearer <access_token>

Query parameters

pageinteger · min: 1Optional

Номер страницы для пагинации.

Минимальное значение: 1
По умолчанию: 1

Default: 1Example: 1

limitinteger · min: 1 · max: 100Optional

Количество записей на странице.

Минимальное значение: 1
Максимальное значение: 100
По умолчанию: 20

Default: 20Example: 20

sortstring · enumOptional

Направление сортировки по дате публикации.

asc - по возрастанию (сначала старые)
desc - по убыванию (сначала новые)
По умолчанию: desc

Default: descExample: descPossible values:

id_groupstringOptional

Фильтр по ID страницы или группы. Возвращаются только посты для указанной группы.

type_socialstring · enumOptional

Фильтр по типу социальной сети. Доступные значения:

vk - ВКонтакте
tg - Telegram
ok - Одноклассники
ig_business - Instagram Business
max - Max
rutube - Rutube
fb - Facebook

Possible values:

active_stopstring · enumOptional

Фильтр по статусу активности.

0 - активные посты
1 - остановленные посты

Possible values:

post_daystringOptional

Фильтр по типу расписания.

everyday - ежедневные посты
Конкретная дата в формате Y-m-d (например, 2024-01-15)

statusstring · enumOptional

Фильтр по статусу поста.

active - только активные (не остановленные и с датой в будущем)
inactive - остановленные или уже опубликованные
all - все посты
По умолчанию: all

Default: allExample: allPossible values:

searchstring · min: 1 · max: 255Optional

Поиск по тексту поста. Поиск осуществляется по частичному совпадению.

date_fromstring · date-timeOptional

Начальная дата для фильтрации (включительно). Формат: Y-m-d H:i:s или Y-m-d Пример: 2024-01-01 00:00:00

date_tostring · date-timeOptional

Конечная дата для фильтрации (включительно). Формат: Y-m-d H:i:s или Y-m-d Пример: 2024-12-31 23:59:59

Responses

200

Успешный ответ. Возвращается объект с полем response, содержащим:

items — массив объектов с данными каждого поста
count — общее количество постов, соответствующих критериям
page — текущая страница
limit — количество записей на странице
total_pages — общее количество страниц
filters_applied — примененные фильтры (если были использованы)

application/json

400

Ошибка запроса. Возможные причины:

Токен не передан в заголовке Authorization или параметре access_token
Отсутствуют обязательные заголовки
Некорректный формат параметров

application/json

401

Неавторизованный доступ. Возможные причины:

Токен недействителен или просрочен
Пользователь не найден

application/json

500

Внутренняя ошибка сервера. Возможные причины:

Ошибка базы данных
Проблемы с подключением

application/json

get/v3/method/posts.getList

GET /api/v3/method/posts.getList HTTP/1.1
Host: vposter.ru
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "response": {
    "items": [
      {
        "id": 12345,
        "id_group": "67890",
        "name": "Моя группа ВКонтакте",
        "name_autopost": "Рекламный пост (API)",
        "photo": "https://pp.vkuserphoto.ru/s/v1/ig2/trWmLifY0iCMeIn7zTkhU...",
        "date_post": "2024-01-15T10:30:00+03:00",
        "post_day": "2024-01-15",
        "message": "Текст поста с #реклама",
        "attachments": "photo123_456",
        "attachments_json": [
          {
            "type": "photo",
            "id": 457749080,
            "preview": "https://pp.vkuserphoto.ru/s/v1/ig2/SIXJehNSqRY1nyfc7s-fB9-FmQ8LCWaVl-vN0FGIDulCNpQSt_aF-20Rki6dVPsL02v0hWR4b6p5OC6DXtNhZNi9.jpg?quality=95&as=32x57,48x85,72x128,108x192,160x284,240x427,360x640,480x853,540x960,640x1138,720x1280,1080x1920,1280x2276,1440x2560&from=bu&cs=640x0",
            "original": "https://pp.vkuserphoto.ru/s/v1/ig2/SIXJehNSqRY1nyfc7s-fB9-FmQ8LCWaVl-vN0FGIDulCNpQSt_aF-20Rki6dVPsL02v0hWR4b6p5OC6DXtNhZNi9.jpg?quality=95&as=32x57,48x85,72x128,108x192,160x284,240x427,360x640,480x853,540x960,640x1138,720x1280,1080x1920,1280x2276,1440x2560&from=bu",
            "owner_id": 116945277,
            "access_key": "74781521bc8879f57c"
          },
          {
            "type": "photo",
            "id": 457749081,
            "preview": "https://pp.vkuserphoto.ru/s/v1/ig2/iUTfrZvhO6IpMFJAD7a1mc6-X2ALSktFjosUGtweGp_fGlADb1DINs6ZZsf5VOp8ohrj1lIWBUeiIRBnB98V7T44.jpg?quality=95&as=32x57,48x85,72x128,108x192,160x284,240x427,360x640,480x853,540x960,640x1138,720x1280,1080x1920,1280x2276,1440x2560&from=bu&cs=640x0",
            "original": "https://pp.vkuserphoto.ru/s/v1/ig2/iUTfrZvhO6IpMFJAD7a1mc6-X2ALSktFjosUGtweGp_fGlADb1DINs6ZZsf5VOp8ohrj1lIWBUeiIRBnB98V7T44.jpg?quality=95&as=32x57,48x85,72x128,108x192,160x284,240x427,360x640,480x853,540x960,640x1138,720x1280,1080x1920,1280x2276,1440x2560&from=bu",
            "owner_id": 116945277,
            "access_key": "9440bb15a589dd577f"
          }
        ],
        "repost": 0,
        "repost_object": "",
        "repost_comment": "",
        "signed": 0,
        "mark_as_ads": 1,
        "close_comments": 0,
        "wall_pin": 0,
        "del_task": 0,
        "date_task": 0,
        "del_task_date": "2026-02-22",
        "stop_post": 0,
        "stop_post_date": "2026-02-22",
        "donut": 0,
        "donut_type": 0,
        "delete_sociate": 0,
        "delete_clock": "",
        "delete_minutes": "",
        "status_post": "0",
        "date_create": "2024-01-14T15:23:45+03:00",
        "type_social": "vk",
        "primary_attachments_mode": 0,
        "mute_notifications": 0,
        "juridical_details": {
          "fio": "Иванов Иван Иванович",
          "inn": "1234567890",
          "kpp": "",
          "posts_summ": "10000.00",
          "type": "physical",
          "flags": [],
          "kktus": [
            "token123"
          ],
          "phone": "+71234567890",
          "person": [
            "advertiser"
          ],
          "foreign": "false",
          "vat_rate": "20",
          "foreign_inn": "",
          "contract_date": "2024-01-01",
          "contract_summ": "10000.00",
          "type_marking": "0",
          "description_ord": "text",
          "contract_serial": "",
          "contract_date_end": "",
          "foreign_epayment_method": "",
          "foreign_oksm_country_code": "",
          "foreign_registration_number": ""
        },
        "co_owner": 0,
        "co_owner_ids": "",
        "text_error": "",
        "status_post_social": 1,
        "post_id": 4677
      }
    ],
    "count": 150,
    "page": 2,
    "limit": 50,
    "total_pages": 3,
    "filters_applied": {
      "status": "active",
      "type_social": "vk",
      "search": "реклама"
    }
  }
}

Получить информацию о посте

get

Возвращает информацию о посте по его идентификатору.

Authorizations

AuthorizationstringRequired

Bearer‑токен, полученный через vposter.ru/dev. Передаётся в заголовке запроса: Authorization: Bearer <access_token>

Query parameters

idintegerRequired

Идентификатор публикации

Example: 12345

Responses

200

Успешный ответ. Возвращается объект с полем response, содержащим:

items — массив объекта с данными страницы/группы.

application/json

400

Ошибка запроса. Возможные причины:

Токен не передан в заголовке Authorization или параметре access_token
Отсутствуют обязательные заголовки
Некорректный формат параметров

application/json

401

Неавторизованный доступ. Возможные причины:

Токен недействителен или просрочен
Пользователь не найден

application/json

500

Внутренняя ошибка сервера. Возможные причины:

Ошибка базы данных
Проблемы с подключением

application/json

get/v3/method/posts.getById

GET /api/v3/method/posts.getById?id=1 HTTP/1.1
Host: vposter.ru
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "response": {
    "items": [
      {
        "id": 12345,
        "id_group": "67890",
        "name": "Моя группа ВКонтакте",
        "name_autopost": "Рекламный пост (API)",
        "photo": "https://pp.vkuserphoto.ru/s/v1/ig2/trWmLifY0iCMeIn7zTkhU...",
        "date_post": "2024-01-15T10:30:00+03:00",
        "post_day": "2024-01-15",
        "message": "Текст поста с #реклама",
        "attachments": "photo123_456",
        "attachments_json": [
          {
            "type": "photo",
            "id": 457749080,
            "preview": "https://pp.vkuserphoto.ru/s/v1/ig2/SIXJehNSqRY1nyfc7s-fB9-FmQ8LCWaVl-vN0FGIDulCNpQSt_aF-20Rki6dVPsL02v0hWR4b6p5OC6DXtNhZNi9.jpg?quality=95&as=32x57,48x85,72x128,108x192,160x284,240x427,360x640,480x853,540x960,640x1138,720x1280,1080x1920,1280x2276,1440x2560&from=bu&cs=640x0",
            "original": "https://pp.vkuserphoto.ru/s/v1/ig2/SIXJehNSqRY1nyfc7s-fB9-FmQ8LCWaVl-vN0FGIDulCNpQSt_aF-20Rki6dVPsL02v0hWR4b6p5OC6DXtNhZNi9.jpg?quality=95&as=32x57,48x85,72x128,108x192,160x284,240x427,360x640,480x853,540x960,640x1138,720x1280,1080x1920,1280x2276,1440x2560&from=bu",
            "owner_id": 116945277,
            "access_key": "74781521bc8879f57c"
          },
          {
            "type": "photo",
            "id": 457749081,
            "preview": "https://pp.vkuserphoto.ru/s/v1/ig2/iUTfrZvhO6IpMFJAD7a1mc6-X2ALSktFjosUGtweGp_fGlADb1DINs6ZZsf5VOp8ohrj1lIWBUeiIRBnB98V7T44.jpg?quality=95&as=32x57,48x85,72x128,108x192,160x284,240x427,360x640,480x853,540x960,640x1138,720x1280,1080x1920,1280x2276,1440x2560&from=bu&cs=640x0",
            "original": "https://pp.vkuserphoto.ru/s/v1/ig2/iUTfrZvhO6IpMFJAD7a1mc6-X2ALSktFjosUGtweGp_fGlADb1DINs6ZZsf5VOp8ohrj1lIWBUeiIRBnB98V7T44.jpg?quality=95&as=32x57,48x85,72x128,108x192,160x284,240x427,360x640,480x853,540x960,640x1138,720x1280,1080x1920,1280x2276,1440x2560&from=bu",
            "owner_id": 116945277,
            "access_key": "9440bb15a589dd577f"
          }
        ],
        "repost": 0,
        "repost_object": "",
        "repost_comment": "",
        "signed": 0,
        "mark_as_ads": 1,
        "close_comments": 0,
        "wall_pin": 0,
        "del_task": 0,
        "date_task": 0,
        "del_task_date": "2026-02-22",
        "stop_post": 0,
        "stop_post_date": "2026-02-22",
        "donut": 0,
        "donut_type": 0,
        "delete_sociate": 0,
        "delete_clock": "",
        "delete_minutes": "",
        "status_post": "0",
        "date_create": "2024-01-14T15:23:45+03:00",
        "type_social": "vk",
        "primary_attachments_mode": 0,
        "mute_notifications": 0,
        "juridical_details": {
          "fio": "Иванов Иван Иванович",
          "inn": "1234567890",
          "kpp": "",
          "posts_summ": "10000.00",
          "type": "physical",
          "flags": [],
          "kktus": [
            "token123"
          ],
          "phone": "+71234567890",
          "person": [
            "advertiser"
          ],
          "foreign": "false",
          "vat_rate": "20",
          "foreign_inn": "",
          "contract_date": "2024-01-01",
          "contract_summ": "10000.00",
          "type_marking": "0",
          "description_ord": "text",
          "contract_serial": "",
          "contract_date_end": "",
          "foreign_epayment_method": "",
          "foreign_oksm_country_code": "",
          "foreign_registration_number": ""
        },
        "co_owner": 0,
        "co_owner_ids": "",
        "text_error": "",
        "status_post_social": 1,
        "post_id": 4677
      }
    ]
  }
}

Запланировать публикацию поста

post

Создаёт пост в разделе «Отложенные посты» на указанной странице/группе.

Authorizations

AuthorizationstringRequired

Bearer‑токен, полученный через vposter.ru/dev. Передаётся в заголовке запроса: Authorization: Bearer <access_token>

Body

id_groupstringRequired

Обязательный. ID страницы или группы, куда будет опубликован пост. Получается через метод /v3/method/groups.getMy.

Example: 123456

name_autopoststringOptional

Название поста для отображения в запланированных постах. Если не указано, будет сгенерировано автоматически.

Example: Рекламный пост о новой коллекции

primary_attachments_modeinteger · enumOptional

Режим отображения вложений: (для vk)

0 — сетка
1 — карусель

Example: 1Possible values:

type_socialstring · enumRequired

Обязательный. Социальная сеть для публикации:

vk — ВКонтакте
tg — Telegram
ok — Одноклассники
ig_business — Instagram Business
max — Max
rutube — Rutube
fb — Facebook

Example: vkPossible values:

date_poststringOptional

Дата и время публикации. Если не задано, то публикуется через минуту. Формат: ГГГГ-ММ-ДД ЧЧ:ММ

Example: 2027-02-21 15:40

post_daystring · enumRequired

Обязательный. Периодичность публикации:

oneraz — однократно
everyday — ежедневно
budday — по будням
weekends — по выходным
every2day — раз в 2 дня
every3day — раз в 3 дня
и так далее (цифра указывает интервал)

Example: onerazPossible values:

messagestringOptional

Текст публикуемого поста. Поддерживается форматирование для tg и max

Поддерживаемое форматирование HTML в тексте:

tg — <b><i><strike><u><span><a><blockquote><blockquote_expandable><code><pre>
max — <b><i><code><blockquote><a><h1><strike><u>

Информация по тегам:

<b>text</b> — жирный
<i>text</i> — курсив
<strike>text</strike> — зачёркнутый
<span class="tg-spoiler">text</span> — скрытый
<a href="link">text</a> — ссылка
<blockquote class="blockquote">text<blockquote> — цитата
<blockquote_expandable class="expandable">text<blockquote_expandable> — цитата с раскрытием
<pre class="code-block">text</pre> — код
<code>text</code> — моноширинный
<h1 class="title">text</h1> — заголовок

Example: Наша новая коллекция уже в продаже! 🎉

repost_objectstringOptional

Ссылка на пост для репоста.

Поддерживаемые соцсети:

vk — ВКонтакте
tg — Telegram
ok — Одноклассники

Example: https://vk.com/wall66748_3675

repost_commentstringOptional

Комментарий к репосту (если выполняется репост).

Поддерживаемые соцсети:

vk — ВКонтакте
tg — Telegram
ok — Одноклассники

Example: Отличный пост, делюсь с подписчиками!

delete_post_datestringOptional

Дата автоматического удаления поста из сервиса (если требуется). Формат: ГГГГ-ММ-ДД

Example: 2025-02-28

delete_clockstringOptional

Час автоматического удаления поста из соцсети. Значение от 0 до 4382.

Example: 23

delete_minutesstringOptional

Минута автоматического удаления поста из соцсети. Значение от 0 до 59.

Example: 59

stop_post_datestringOptional

Дата автоматического приостановления поста на сервисе (если требуется). Формат: ГГГГ-ММ-ДД

Example: 2025-02-28

signedinteger · enumOptional

Добавлять подпись от имени автора: (для vk)

0 — не добавлять
1 — добавлять

Example: 0Possible values:

mute_notificationsinteger · enumOptional

Отключить уведомления о публикации: (для vk, ok, tg, max)

0 — уведомления включены
1 — уведомления отключены

Example: 0Possible values:

close_commentsinteger · enumOptional

Закрыть комментарии к посту: (для vk, ok)

0 — комментарии открыты
1 — комментарии закрыты

Example: 0Possible values:

wall_pininteger · enumOptional

Закрепить пост на стене: (для vk, tg, max)

0 — не закреплять
1 — закрепить

Example: 0Possible values:

wall_unpin_datestringOptional

Дата и время открепления поста (если он был закреплён). Формат: ГГГГ-ММ-ДД ЧЧ:ММ (для vk, tg, max)

Example: 2025-02-28 15:40

co_owner_idsstringOptional

Пригласить соавторов для vk. Укажите VK ID соавторов через запятую. ID сообществ указывайте через знак "-". Лимит 4 соавтора!

Example: -79668981

del_taskinteger · enumOptional

Удалить пост из сервиса после публикации:

0 — оставить в сервисе
1 — удалить после публикации из сервиса

Example: 0Possible values:

donut_typeinteger · enumOptional

Видимость для VK Donut: (для vk)

0 — Неограниченно
1 — На 1 день
2 — На 2 дня
3 — На 3 дня
4 — На 4 дня
5 — На 5 дней
6 — На 6 дней
7 — На 7 дней

Example: 0Possible values:

attachmentsstringOptional

Старый формат. Любые вложения из VK: (для vk)

Если объектов несколько, укажите их через запятую ,

Формат описания медиавложения: {type}{owner_id}_{media_id}, где:

type — тип медиавложения:
- photo — фотография
- video — видеозапись
- audio — аудиозапись
- doc — файл
- poll — опрос
- audio_playlist — плейлист с аудио
- owner_id — идентификатор владельца медиавложения. Идентификатор сообщества должен начинаться со знака -
- media_id — идентификатор медиавложения

Данный формат позволяет передавать любые вложения из VK. Это тот же формат, который используется в VK API.

Example: photo-79668981_457342016,photo-79668981_457341976

attachments_jsonobjectOptional

Новый формат. Визуальные вложения к посту (изображения, видео, документы и т.д.).

Массив объектов с данными о вложениях.

Каждый объект массива содержит:

Фото (для vk, ok, fb, ig_business, tg, max)

id (number) — уникальный идентификатор вложения
type (string) — тип вложения (photo)
preview (string) — URL превью изображения
original (string) — URL оригинального изображения
owner_id (number) — ID владельца
access_key (string) — ключ доступа

Видео (для vk, ok, fb, tg, rutube, max)

id (number) — уникальный идентификатор вложения
size (number) — размер видео в байтах
type (string) — тип вложения (video)
title (string) — название видео
preview (string) — URL превью изображения
duration (number) — длительность в секундах
owner_id (number) — ID владельца
type_video (string) — тип видео (video или short_video)

Аудио (для vk)

id (number) — уникальный идентификатор вложения
type (string) — тип вложения (audio)
title (string) — название
artist (string) — исполнитель
duration (number) — длительность в секундах
owner_id (number) — ID владельца

Документ (для vk, tg, max)

id (number) — уникальный идентификатор вложения
ext (string) — формат файла, например docx
url (string) — прямая ссылка на файл
size (number) — размер файла в байтах
type (string) — тип вложения (doc)
title (string) — название документа
owner_id (number) — ID владельца

Опрос (для vk, ok, tg)

id (number) — всегда одно значение 600
type (string) — тип вложения (poll)
answers (items) — массив ответов ["Первый вариант", "Второй вариант", "Третий вариант"]
question (string) — заголовок опроса

Карта (для vk, ok)

id (number) — всегда одно значение 700
type (string) — тип вложения (geo)
lat (items) — широта
long (items) — долгота
title (string) — название местоположения

Источник (для vk)

id (number) — всегда одно значение 900
url (string) — ссылка на источник
type (string) — тип вложения (copyright)

Первый комментарий (для vk)

id (number) — всегда одно значение 800
text (string) — текст комментария
type (string) — тип вложения (comment)

Сниппет ссылки (для vk, ok, fb, tg)

id (number) — всегда одно значение 555
url (string) — HTTPS ссылка
type (string) — тип вложения (link)
image (string) — URL превью изображения
domain (string) — домен страницы, например, vposter.ru
title (string) — название страницы
description (string) — короткое описание страницы
link_photo_id (string) — идентификатор изображения в VK

Кнопка действия (для vk)

id (number) — всегда одно значение 378
type (string) — тип вложения (action_button)
text_button (string) — текст кнопки (Написать сообществу (открывает чат с сообществом), Больше постов — в канале (переводит в канал сообщества), Смотреть товары (ведёт на витрину магазина), Поддержать автора (открывает список уровней VK Donut))
type_button (string) — тип кнопки (message_to_community, message_to_channel, open_market, donut_levels)

Кнопки (для tg, max)

id (number) — всегда одно значение 1000
type (string) — тип вложения (button_tg)
buttons_link (items) — массив ссылок по порядку от 1-10 (["https://vposter.ru/", "https://vposter.ru/"])
buttons_name (items) — массив название по порядку от 1-10 (["Кнопка 1", "Кнопка 2"])

Важно: Используйте либо attachments (старый формат), либо attachments_json (новый формат). Не используйте оба параметра одновременно.

Example:

[{"id":457749080,"type":"photo","preview":"https://pp.vkuserphoto.ru/s/v1/ig2/SIXJehNSqRY1nyfc7s-fB9-FmQ8LCWaVl-vN0FGIDulCNpQSt_aF-20Rki6dVPsL02v0hWR4b6p5OC6DXtNhZNi9.jpg?quality=95&as=32x57,48x85,72x128,108x192,160x284,240x427,360x640,480x853,540x960,640x1138,720x1280,1080x1920,1280x2276,1440x2560&from=bu&cs=640x0","original":"https://pp.vkuserphoto.ru/s/v1/ig2/SIXJehNSqRY1nyfc7s-fB9-FmQ8LCWaVl-vN0FGIDulCNpQSt_aF-20Rki6dVPsL02v0hWR4b6p5OC6DXtNhZNi9.jpg?quality=95&as=32x57,48x85,72x128,108x192,160x284,240x427,360x640,480x853,540x960,640x1138,720x1280,1080x1920,1280x2276,1440x2560&from=bu","owner_id":116945277,"access_key":"74781521bc8879f57c"},{"id":457749081,"type":"photo","preview":"https://pp.vkuserphoto.ru/s/v1/ig2/iUTfrZvhO6IpMFJAD7a1mc6-X2ALSktFjosUGtweGp_fGlADb1DINs6ZZsf5VOp8ohrj1lIWBUeiIRBnB98V7T44.jpg?quality=95&as=32x57,48x85,72x128,108x192,160x284,240x427,360x640,480x853,540x960,640x1138,720x1280,1080x1920,1280x2276,1440x2560&from=bu&cs=640x0","original":"https://pp.vkuserphoto.ru/s/v1/ig2/iUTfrZvhO6IpMFJAD7a1mc6-X2ALSktFjosUGtweGp_fGlADb1DINs6ZZsf5VOp8ohrj1lIWBUeiIRBnB98V7T44.jpg?quality=95&as=32x57,48x85,72x128,108x192,160x284,240x427,360x640,480x853,540x960,640x1138,720x1280,1080x1920,1280x2276,1440x2560&from=bu","owner_id":116945277,"access_key":"9440bb15a589dd577f"}]

Responses

200

Пост успешно запланирован. Ответ может содержать идентификатор созданного поста.

application/json

400

Некорректный запрос. Возможные причины:

Токен не передан в заголовке Authorization
Отсутствуют обязательные параметры
Неверный формат данных

application/json

401

Неавторизованный доступ. Возможные причины:

Токен недействителен или просрочен

application/json

409

Место занято. Возможные причины:

Пост уже запланирован в это время на данной странице.

application/json

429

Достингут лимит постов. Возможные причины:

Одновременно допускается не более 25 публикаций на одно время на разных страницах.

application/json

500

Внутренняя ошибка сервера. Не удалось создать пост.

application/json

post/v3/method/posts.create

POST /api/v3/method/posts.create HTTP/1.1
Host: vposter.ru
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 2631

{
  "id_group": "123456",
  "name_autopost": "Рекламный пост о новой коллекции",
  "primary_attachments_mode": 1,
  "type_social": "vk",
  "date_post": "2027-02-21 15:40",
  "post_day": "oneraz",
  "message": "Наша новая коллекция уже в продаже! 🎉",
  "repost_object": "https://vk.com/wall66748_3675",
  "repost_comment": "Отличный пост, делюсь с подписчиками!",
  "delete_post_date": "2025-02-28",
  "delete_clock": "23",
  "delete_minutes": "59",
  "stop_post_date": "2025-02-28",
  "signed": 0,
  "mute_notifications": 0,
  "close_comments": 0,
  "wall_pin": 0,
  "wall_unpin_date": "2025-02-28 15:40",
  "co_owner_ids": "-79668981",
  "del_task": 0,
  "donut_type": 0,
  "attachments": "photo-79668981_457342016,photo-79668981_457341976",
  "attachments_json": [
    {
      "id": 457749080,
      "type": "photo",
      "preview": "https://pp.vkuserphoto.ru/s/v1/ig2/SIXJehNSqRY1nyfc7s-fB9-FmQ8LCWaVl-vN0FGIDulCNpQSt_aF-20Rki6dVPsL02v0hWR4b6p5OC6DXtNhZNi9.jpg?quality=95&as=32x57,48x85,72x128,108x192,160x284,240x427,360x640,480x853,540x960,640x1138,720x1280,1080x1920,1280x2276,1440x2560&from=bu&cs=640x0",
      "original": "https://pp.vkuserphoto.ru/s/v1/ig2/SIXJehNSqRY1nyfc7s-fB9-FmQ8LCWaVl-vN0FGIDulCNpQSt_aF-20Rki6dVPsL02v0hWR4b6p5OC6DXtNhZNi9.jpg?quality=95&as=32x57,48x85,72x128,108x192,160x284,240x427,360x640,480x853,540x960,640x1138,720x1280,1080x1920,1280x2276,1440x2560&from=bu",
      "owner_id": 116945277,
      "access_key": "74781521bc8879f57c"
    },
    {
      "id": 457749081,
      "type": "photo",
      "preview": "https://pp.vkuserphoto.ru/s/v1/ig2/iUTfrZvhO6IpMFJAD7a1mc6-X2ALSktFjosUGtweGp_fGlADb1DINs6ZZsf5VOp8ohrj1lIWBUeiIRBnB98V7T44.jpg?quality=95&as=32x57,48x85,72x128,108x192,160x284,240x427,360x640,480x853,540x960,640x1138,720x1280,1080x1920,1280x2276,1440x2560&from=bu&cs=640x0",
      "original": "https://pp.vkuserphoto.ru/s/v1/ig2/iUTfrZvhO6IpMFJAD7a1mc6-X2ALSktFjosUGtweGp_fGlADb1DINs6ZZsf5VOp8ohrj1lIWBUeiIRBnB98V7T44.jpg?quality=95&as=32x57,48x85,72x128,108x192,160x284,240x427,360x640,480x853,540x960,640x1138,720x1280,1080x1920,1280x2276,1440x2560&from=bu",
      "owner_id": 116945277,
      "access_key": "9440bb15a589dd577f"
    }
  ],
  "ads_items": {
    "fio": "Гусманова Регина Таузиховна",
    "inn": "024901056383",
    "kpp": "",
    "posts_summ": "400",
    "type": "ip",
    "flags": [],
    "kktus": [
      "12.1.3"
    ],
    "phone": "",
    "address": "123456, Москва, ул. Льва Толстого, д. 16",
    "person": [
      "advertiser"
    ],
    "foreign": "false",
    "vat_rate": "without_vat",
    "foreign_inn": "",
    "contract_date": "2026-02-19",
    "contract_summ": "400",
    "type_marking": "0",
    "description_ord": "",
    "contract_serial": "",
    "contract_date_end": "",
    "foreign_epayment_method": "",
    "foreign_oksm_country_code": "",
    "foreign_registration_number": ""
  }
}

{
  "response": {
    "post_id": 12345,
    "created_at": "2026-02-19 20:13:34"
  }
}

Отредактировать пост

put

Редактирует пост в разделе «Отложенные посты» на указанной странице/группе.

Authorizations

AuthorizationstringRequired

Bearer‑токен, полученный через vposter.ru/dev. Передаётся в заголовке запроса: Authorization: Bearer <access_token>

Body

idintegerRequired

Обязательный. ID поста на сервисе

Example: 123456

id_groupstringRequired

Обязательный. ID страницы или группы, куда будет опубликован пост. Получается через метод /v3/method/groups.getMy.

Example: 123456

name_autopoststringOptional

Example: Рекламный пост о новой коллекции

primary_attachments_modeinteger · enumOptional

Режим отображения вложений: (для vk)

0 — сетка
1 — карусель

Example: 1Possible values:

type_socialstring · enumRequired

Обязательный. Социальная сеть для публикации:

vk — ВКонтакте
tg — Telegram
ok — Одноклассники
ig_business — Instagram Business
max — Max
rutube — Rutube
fb — Facebook

Example: vkPossible values:

date_poststringRequired

Обязательный. Дата и время публикации. Формат: ГГГГ-ММ-ДД ЧЧ:ММ

Example: 2027-02-21 15:40

post_daystring · enumRequired

Обязательный. Периодичность публикации:

oneraz — однократно
everyday — ежедневно
budday — по будням
weekends — по выходным
every2day — раз в 2 дня
every3day — раз в 3 дня
и так далее (цифра указывает интервал)

Example: onerazPossible values:

messagestringOptional

Текст публикуемого поста. Поддерживается форматирование для tg и max

Поддерживаемое форматирование HTML в тексте:

tg — <b><i><strike><u><span><a><blockquote><blockquote_expandable><code><pre>
max — <b><i><code><blockquote><a><h1><strike><u>

Информация по тегам:

<b>text</b> — жирный
<i>text</i> — курсив
<strike>text</strike> — зачёркнутый
<span class="tg-spoiler">text</span> — скрытый
<a href="link">text</a> — ссылка
<blockquote class="blockquote">text<blockquote> — цитата
<blockquote_expandable class="expandable">text<blockquote_expandable> — цитата с раскрытием
<pre class="code-block">text</pre> — код
<code>text</code> — моноширинный
<h1 class="title">text</h1> — заголовок

Example: Наша новая коллекция уже в продаже! 🎉

repost_objectstringOptional

Ссылка на пост для репоста.

Поддерживаемые соцсети:

vk — ВКонтакте
tg — Telegram
ok — Одноклассники

Example: https://vk.com/wall66748_3675

repost_commentstringOptional

Комментарий к репосту (если выполняется репост).

Поддерживаемые соцсети:

vk — ВКонтакте
tg — Telegram
ok — Одноклассники

Example: Отличный пост, делюсь с подписчиками!

delete_post_datestringOptional

Дата автоматического удаления поста из сервиса (если требуется). Формат: ГГГГ-ММ-ДД

Example: 2025-02-28

delete_clockstringOptional

Час автоматического удаления поста из соцсети. Значение от 0 до 4382.

Example: 23

delete_minutesstringOptional

Минута автоматического удаления поста из соцсети. Значение от 0 до 59.

Example: 59

stop_post_datestringOptional

Дата автоматического приостановления поста на сервисе (если требуется). Формат: ГГГГ-ММ-ДД

Example: 2025-02-28

signedinteger · enumOptional

Добавлять подпись от имени автора: (для vk)

0 — не добавлять
1 — добавлять

Example: 0Possible values:

mute_notificationsinteger · enumOptional

Отключить уведомления о публикации: (для vk, ok, tg, max)

0 — уведомления включены
1 — уведомления отключены

Example: 0Possible values:

close_commentsinteger · enumOptional

Закрыть комментарии к посту: (для vk, ok)

0 — комментарии открыты
1 — комментарии закрыты

Example: 0Possible values:

wall_pininteger · enumOptional

Закрепить пост на стене: (для vk, tg, max)

0 — не закреплять
1 — закрепить

Example: 0Possible values:

wall_unpin_datestringOptional

Дата и время открепления поста (если он был закреплён). Формат: ГГГГ-ММ-ДД ЧЧ:ММ (для vk, tg, max)

Example: 2025-02-28 15:40

co_owner_idsstringOptional

Example: -79668981

del_taskinteger · enumOptional

Удалить пост из сервиса после публикации:

0 — оставить в сервисе
1 — удалить после публикации из сервиса

Example: 0Possible values:

donut_typeinteger · enumOptional

Видимость для VK Donut: (для vk)

0 — Неограниченно
1 — На 1 день
2 — На 2 дня
3 — На 3 дня
4 — На 4 дня
5 — На 5 дней
6 — На 6 дней
7 — На 7 дней

Example: 0Possible values:

attachmentsstringOptional

Старый формат. Любые вложения из VK: (для vk)

Если объектов несколько, укажите их через запятую ,

Формат описания медиавложения: {type}{owner_id}_{media_id}, где:

type — тип медиавложения:
- photo — фотография
- video — видеозапись
- audio — аудиозапись
- doc — файл
- poll — опрос
- audio_playlist — плейлист с аудио
- owner_id — идентификатор владельца медиавложения. Идентификатор сообщества должен начинаться со знака -
- media_id — идентификатор медиавложения

Данный формат позволяет передавать любые вложения из VK. Это тот же формат, который используется в VK API.

Example: photo-photo-79668981_457342016,photo-79668981_457341976

attachments_jsonstringOptional

Новый формат. Визуальные вложения к посту (изображения, видео, документы и т.д.).

Массив объектов с данными о вложениях.

Каждый объект массива содержит:

Фото (для vk, ok, fb, ig_business, tg, max)

id (number) — уникальный идентификатор вложения
type (string) — тип вложения (photo)
preview (string) — URL превью изображения
original (string) — URL оригинального изображения
owner_id (number) — ID владельца
access_key (string) — ключ доступа

Видео (для vk, ok, fb, tg, rutube, max)

id (number) — уникальный идентификатор вложения
size (number) — размер видео в байтах
type (string) — тип вложения (video)
title (string) — название видео
preview (string) — URL превью изображения
duration (number) — длительность в секундах
owner_id (number) — ID владельца
type_video (string) — тип видео (video или short_video)

Аудио (для vk)

id (number) — уникальный идентификатор вложения
type (string) — тип вложения (audio)
title (string) — название
artist (string) — исполнитель
duration (number) — длительность в секундах
owner_id (number) — ID владельца

Документ (для vk, tg, max)

id (number) — уникальный идентификатор вложения
ext (string) — формат файла, например docx
url (string) — прямая ссылка на файл
size (number) — размер файла в байтах
type (string) — тип вложения (doc)
title (string) — название документа
owner_id (number) — ID владельца

Опрос (для vk, ok, tg)

id (number) — всегда одно значение 600
type (string) — тип вложения (poll)
answers (items) — массив ответов ["Первый вариант", "Второй вариант", "Третий вариант"]
question (string) — заголовок опроса

Карта (для vk, ok)

id (number) — всегда одно значение 700
type (string) — тип вложения (geo)
lat (items) — широта
long (items) — долгота
title (string) — название местоположения

Источник (для vk)

id (number) — всегда одно значение 900
url (string) — ссылка на источник
type (string) — тип вложения (copyright)

Первый комментарий (для vk)

id (number) — всегда одно значение 800
text (string) — текст комментария
type (string) — тип вложения (comment)

Сниппет ссылки (для vk, ok, fb, tg)

id (number) — всегда одно значение 555
url (string) — HTTPS ссылка
type (string) — тип вложения (link)
image (string) — URL превью изображения
domain (string) — домен страницы, например, vposter.ru
title (string) — название страницы
description (string) — короткое описание страницы
link_photo_id (string) — идентификатор изображения в VK

Кнопка действия (для vk)

id (number) — всегда одно значение 378
type (string) — тип вложения (action_button)
text_button (string) — текст кнопки (Написать сообществу (открывает чат с сообществом), Больше постов — в канале (переводит в канал сообщества), Смотреть товары (ведёт на витрину магазина), Поддержать автора (открывает список уровней VK Donut))
type_button (string) — тип кнопки (message_to_community, message_to_channel, open_market, donut_levels)

Кнопки (для tg, max)

id (number) — всегда одно значение 1000
type (string) — тип вложения (button_tg)
buttons_link (items) — массив ссылок по порядку от 1-10 (["https://vposter.ru/", "https://vposter.ru/"])
buttons_name (items) — массив название по порядку от 1-10 (["Кнопка 1", "Кнопка 2"])

Example:

[ { "id": 457749080, "type": "photo", "preview": "https://pp.vkuserphoto.ru/s/v1/ig2/SIXJehNSqRY1nyfc7s-fB9-FmQ8LCWaVl-vN0FGIDulCNpQSt_aF-20Rki6dVPsL02v0hWR4b6p5OC6DXtNhZNi9.jpg?quality=95&as=32x57,48x85,72x128,108x192,160x284,240x427,360x640,480x853,540x960,640x1138,720x1280,1080x1920,1280x2276,1440x2560&from=bu&cs=640x0", "original": "https://pp.vkuserphoto.ru/s/v1/ig2/SIXJehNSqRY1nyfc7s-fB9-FmQ8LCWaVl-vN0FGIDulCNpQSt_aF-20Rki6dVPsL02v0hWR4b6p5OC6DXtNhZNi9.jpg?quality=95&as=32x57,48x85,72x128,108x192,160x284,240x427,360x640,480x853,540x960,640x1138,720x1280,1080x1920,1280x2276,1440x2560&from=bu", "owner_id": 116945277, "access_key": "74781521bc8879f57c" }, { "id": 457749081, "type": "photo", "preview": "https://pp.vkuserphoto.ru/s/v1/ig2/iUTfrZvhO6IpMFJAD7a1mc6-X2ALSktFjosUGtweGp_fGlADb1DINs6ZZsf5VOp8ohrj1lIWBUeiIRBnB98V7T44.jpg?quality=95&as=32x57,48x85,72x128,108x192,160x284,240x427,360x640,480x853,540x960,640x1138,720x1280,1080x1920,1280x2276,1440x2560&from=bu&cs=640x0", "original": "https://pp.vkuserphoto.ru/s/v1/ig2/iUTfrZvhO6IpMFJAD7a1mc6-X2ALSktFjosUGtweGp_fGlADb1DINs6ZZsf5VOp8ohrj1lIWBUeiIRBnB98V7T44.jpg?quality=95&as=32x57,48x85,72x128,108x192,160x284,240x427,360x640,480x853,540x960,640x1138,720x1280,1080x1920,1280x2276,1440x2560&from=bu", "owner_id": 116945277, "access_key": "9440bb15a589dd577f" } ]

Responses

200

Пост успешно отредактирован. Ответ может содержать идентификатор отредактированного поста.

application/json

400

Некорректный запрос. Возможные причины:

Токен не передан в заголовке Authorization
Отсутствуют обязательные параметры
Неверный формат данных

application/json

401

Неавторизованный доступ. Возможные причины:

Токен недействителен или просрочен

application/json

404

По данному идентификатору пост не найден.

application/json

405

Передан не PUT запрос.

application/json

409

Место занято. Возможные причины:

Пост уже запланирован в это время на данной странице.

application/json

429

Достингут лимит постов. Возможные причины:

Одновременно допускается не более 25 публикаций на одно время на разных страницах.

application/json

500

Внутренняя ошибка сервера. Не удалось создать пост.

application/json

put/v3/method/posts.edit

PUT /api/v3/method/posts.edit HTTP/1.1
Host: vposter.ru
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 2720

{
  "id": 123456,
  "id_group": "123456",
  "name_autopost": "Рекламный пост о новой коллекции",
  "primary_attachments_mode": 1,
  "type_social": "vk",
  "date_post": "2027-02-21 15:40",
  "post_day": "oneraz",
  "message": "Наша новая коллекция уже в продаже! 🎉",
  "repost_object": "https://vk.com/wall66748_3675",
  "repost_comment": "Отличный пост, делюсь с подписчиками!",
  "delete_post_date": "2025-02-28",
  "delete_clock": "23",
  "delete_minutes": "59",
  "stop_post_date": "2025-02-28",
  "signed": 0,
  "mute_notifications": 0,
  "close_comments": 0,
  "wall_pin": 0,
  "wall_unpin_date": "2025-02-28 15:40",
  "co_owner_ids": "-79668981",
  "del_task": 0,
  "donut_type": 0,
  "attachments": "photo-photo-79668981_457342016,photo-79668981_457341976",
  "attachments_json": "[ { \"id\": 457749080, \"type\": \"photo\", \"preview\": \"https://pp.vkuserphoto.ru/s/v1/ig2/SIXJehNSqRY1nyfc7s-fB9-FmQ8LCWaVl-vN0FGIDulCNpQSt_aF-20Rki6dVPsL02v0hWR4b6p5OC6DXtNhZNi9.jpg?quality=95&as=32x57,48x85,72x128,108x192,160x284,240x427,360x640,480x853,540x960,640x1138,720x1280,1080x1920,1280x2276,1440x2560&from=bu&cs=640x0\", \"original\": \"https://pp.vkuserphoto.ru/s/v1/ig2/SIXJehNSqRY1nyfc7s-fB9-FmQ8LCWaVl-vN0FGIDulCNpQSt_aF-20Rki6dVPsL02v0hWR4b6p5OC6DXtNhZNi9.jpg?quality=95&as=32x57,48x85,72x128,108x192,160x284,240x427,360x640,480x853,540x960,640x1138,720x1280,1080x1920,1280x2276,1440x2560&from=bu\", \"owner_id\": 116945277, \"access_key\": \"74781521bc8879f57c\" }, { \"id\": 457749081, \"type\": \"photo\", \"preview\": \"https://pp.vkuserphoto.ru/s/v1/ig2/iUTfrZvhO6IpMFJAD7a1mc6-X2ALSktFjosUGtweGp_fGlADb1DINs6ZZsf5VOp8ohrj1lIWBUeiIRBnB98V7T44.jpg?quality=95&as=32x57,48x85,72x128,108x192,160x284,240x427,360x640,480x853,540x960,640x1138,720x1280,1080x1920,1280x2276,1440x2560&from=bu&cs=640x0\", \"original\": \"https://pp.vkuserphoto.ru/s/v1/ig2/iUTfrZvhO6IpMFJAD7a1mc6-X2ALSktFjosUGtweGp_fGlADb1DINs6ZZsf5VOp8ohrj1lIWBUeiIRBnB98V7T44.jpg?quality=95&as=32x57,48x85,72x128,108x192,160x284,240x427,360x640,480x853,540x960,640x1138,720x1280,1080x1920,1280x2276,1440x2560&from=bu\", \"owner_id\": 116945277, \"access_key\": \"9440bb15a589dd577f\" } ]",
  "ads_items": {
    "fio": "Гусманова Регина Таузиховна",
    "inn": "024901056383",
    "kpp": "",
    "posts_summ": "400",
    "type": "ip",
    "flags": [],
    "kktus": [
      "12.1.3"
    ],
    "phone": "",
    "address": "123456, Москва, ул. Льва Толстого, д. 16",
    "person": [
      "advertiser"
    ],
    "foreign": "false",
    "vat_rate": "without_vat",
    "foreign_inn": "",
    "contract_date": "2026-02-19",
    "contract_summ": "400",
    "type_marking": "0",
    "description_ord": "",
    "contract_serial": "",
    "contract_date_end": "",
    "foreign_epayment_method": "",
    "foreign_oksm_country_code": "",
    "foreign_registration_number": ""
  }
}

{
  "response": {
    "post_id": 12345,
    "updated_at": "2026-02-19 20:13:34"
  }
}

Удалить пост

delete

Удаляет пост на сервисе.

Authorizations

AuthorizationstringRequired

Bearer‑токен, полученный через vposter.ru/dev. Передаётся в заголовке запроса: Authorization: Bearer <access_token>

Body

idintegerRequired

Обязательный. ID поста на сервисе.

Example: 123456

Responses

200

Пост успешно удален.

application/json

400

Некорректный запрос. Возможные причины:

Токен не передан в заголовке Authorization
Отсутствуют обязательные параметры
Неверный формат данных

application/json

401

Неавторизованный доступ. Возможные причины:

Токен недействителен или просрочен

application/json

404

Пост не найден или у вас нет разрешения на доступ к нему.

application/json

500

Внутренняя ошибка сервера. Не удалось удалить пост.

application/json

delete/v3/method/posts.delete

DELETE /api/v3/method/posts.delete HTTP/1.1
Host: vposter.ru
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 13

{
  "id": 123456
}

{
  "response": {
    "success": true,
    "post_id": 123456,
    "deleted_at": "2026-02-19 20:13:34"
  }
}

Приостановить пост

post

Приостанавливает пост на сервисе.

Authorizations

AuthorizationstringRequired

Bearer‑токен, полученный через vposter.ru/dev. Передаётся в заголовке запроса: Authorization: Bearer <access_token>

Body

idintegerRequired

Обязательный. ID отложенного поста на сервисе.

Example: 123456

Responses

200

Пост успешно приостановлена.

application/json

400

Некорректный запрос. Возможные причины:

Токен не передан в заголовке Authorization
Отсутствуют обязательные параметры
Неверный формат данных

application/json

401

Неавторизованный доступ. Возможные причины:

Токен недействителен или просрочен

application/json

404

Пост не найден или у вас нет разрешения на доступ к нему.

application/json

409

Пост уже приостановлен.

application/json

500

Внутренняя ошибка сервера. Не удалось приостановить пост.

application/json

post/v3/method/posts.pause

POST /api/v3/method/posts.pause HTTP/1.1
Host: vposter.ru
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 13

{
  "id": 123456
}

{
  "response": {
    "success": true,
    "post_id": 123456,
    "stopped_at": "2026-02-19 20:13:34"
  }
}

Включить пост

post

Включает пост на сервисе.

Authorizations

AuthorizationstringRequired

Bearer‑токен, полученный через vposter.ru/dev. Передаётся в заголовке запроса: Authorization: Bearer <access_token>

Body

idintegerRequired

Обязательный. ID отложенного поста на сервисе.

Example: 123456

Responses

200

Пост успешно включен.

application/json

400

Некорректный запрос. Возможные причины:

Токен не передан в заголовке Authorization
Отсутствуют обязательные параметры
Неверный формат данных

application/json

401

Неавторизованный доступ. Возможные причины:

Токен недействителен или просрочен

application/json

404

Пост не найден или у вас нет разрешения на доступ к нему.

application/json

409

Пост уже активирован.

application/json

500

Внутренняя ошибка сервера. Не удалось включить пост.

application/json

post/v3/method/posts.resume

POST /api/v3/method/posts.resume HTTP/1.1
Host: vposter.ru
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 13

{
  "id": 123456
}

{
  "response": {
    "success": true,
    "post_id": 123456,
    "activated_at": "2026-02-19 20:13:34"
  }
}

Получить список запланированных историй

get

Возвращает перечень запланированных историй пользователя с возможностью фильтрации, поиска и пагинации.

Authorizations

AuthorizationstringRequired

Bearer‑токен, полученный через vposter.ru/dev. Передаётся в заголовке запроса: Authorization: Bearer <access_token>

Query parameters

pageinteger · min: 1Optional

Номер страницы для пагинации.

Минимальное значение: 1
По умолчанию: 1

Default: 1Example: 1

limitinteger · min: 1 · max: 100Optional

Количество записей на странице.

Минимальное значение: 1
Максимальное значение: 100
По умолчанию: 20

Default: 20Example: 20

sortstring · enumOptional

Направление сортировки по дате публикации.

asc - по возрастанию (сначала старые)
desc - по убыванию (сначала новые)
По умолчанию: desc

Default: descExample: descPossible values:

id_groupstringOptional

Фильтр по ID страницы или группы. Возвращаются только посты для указанной группы.

type_socialstring · enumOptional

Фильтр по типу социальной сети. Доступные значения:

vk - ВКонтакте
ok - Одноклассники
ig_business - Instagram Business

Possible values:

active_stopstring · enumOptional

Фильтр по статусу активности.

0 - активные истории
1 - остановленные истории

Possible values:

post_daystringOptional

Фильтр по типу расписания.

everyday - ежедневные истории
Конкретная дата в формате Y-m-d (например, 2024-01-15)

statusstring · enumOptional

Фильтр по статусу истории.

active - только активные (не остановленные и с датой в будущем)
inactive - остановленные или уже опубликованные
all - все посты
По умолчанию: all

Default: allExample: allPossible values:

searchstring · min: 1 · max: 255Optional

Поиск по названию истории. Поиск осуществляется по частичному совпадению.

date_fromstring · date-timeOptional

Начальная дата для фильтрации (включительно). Формат: Y-m-d H:i:s или Y-m-d Пример: 2024-01-01 00:00:00

date_tostring · date-timeOptional

Конечная дата для фильтрации (включительно). Формат: Y-m-d H:i:s или Y-m-d Пример: 2024-12-31 23:59:59

Responses

200

Успешный ответ. Возвращается объект с полем response, содержащим:

items — массив объектов с данными каждой истории
count — общее количество историй, соответствующих критериям
page — текущая страница
limit — количество историй на странице
total_pages — общее количество страниц
filters_applied — примененные фильтры (если были использованы)

application/json

400

Ошибка запроса. Возможные причины:

Токен не передан в заголовке Authorization или параметре access_token
Отсутствуют обязательные заголовки
Некорректный формат параметров

application/json

401

Неавторизованный доступ. Возможные причины:

Токен недействителен или просрочен
Пользователь не найден

application/json

500

Внутренняя ошибка сервера. Возможные причины:

Ошибка базы данных
Проблемы с подключением

application/json

get/v3/method/stories.getList

GET /api/v3/method/stories.getList HTTP/1.1
Host: vposter.ru
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "response": {
    "items": [
      {
        "id": 12345,
        "id_group": "67890",
        "name": "Моя группа ВКонтакте",
        "name_autopost": "Рекламная история (API)",
        "stories_time": 0,
        "photo": "https://pp.vkuserphoto.ru/s/v1/ig2/trWmLifY0iCMeIn7zTkhU...",
        "date_post": "2024-01-15T10:30:00+03:00",
        "post_day": "2024-01-15",
        "stories_link_url": "https://example.com",
        "stories_link_text": "go_to",
        "attachments_json": [
          {
            "type": "photo",
            "id": 457749080,
            "preview": "https://pp.vkuserphoto.ru/s/v1/ig2/SIXJehNSqRY1nyfc7s-fB9-FmQ8LCWaVl-vN0FGIDulCNpQSt_aF-20Rki6dVPsL02v0hWR4b6p5OC6DXtNhZNi9.jpg?quality=95&as=32x57,48x85,72x128,108x192,160x284,240x427,360x640,480x853,540x960,640x1138,720x1280,1080x1920,1280x2276,1440x2560&from=bu&cs=640x0",
            "original": "https://pp.vkuserphoto.ru/s/v1/ig2/SIXJehNSqRY1nyfc7s-fB9-FmQ8LCWaVl-vN0FGIDulCNpQSt_aF-20Rki6dVPsL02v0hWR4b6p5OC6DXtNhZNi9.jpg?quality=95&as=32x57,48x85,72x128,108x192,160x284,240x427,360x640,480x853,540x960,640x1138,720x1280,1080x1920,1280x2276,1440x2560&from=bu",
            "owner_id": 116945277,
            "access_key": "74781521bc8879f57c"
          }
        ],
        "mark_as_ads": 1,
        "del_task": 0,
        "date_task": 0,
        "del_task_date": "2026-02-22",
        "stop_post": 0,
        "stop_post_date": "2026-02-22",
        "delete_sociate": 0,
        "delete_clock": "",
        "delete_minutes": "",
        "status_post": "0",
        "date_create": "2024-01-14T15:23:45+03:00",
        "type_social": "vk",
        "juridical_details": {
          "fio": "Иванов Иван Иванович",
          "inn": "1234567890",
          "kpp": "",
          "stories_summ": "10000.00",
          "type": "physical",
          "flags": [],
          "kktus": [
            "token123"
          ],
          "phone": "+71234567890",
          "person": [
            "advertiser"
          ],
          "foreign": "false",
          "vat_rate": "20",
          "foreign_inn": "",
          "contract_date": "2024-01-01",
          "contract_summ": "10000.00",
          "type_marking": "0",
          "description_ord": "text",
          "contract_serial": "",
          "contract_date_end": "",
          "foreign_epayment_method": "",
          "foreign_oksm_country_code": "",
          "foreign_registration_number": ""
        },
        "text_error": "",
        "status_stories_social": 1,
        "stories_id": 4677
      }
    ],
    "count": 150,
    "page": 2,
    "limit": 50,
    "total_pages": 3,
    "filters_applied": {
      "status": "active",
      "type_social": "vk",
      "search": "реклама"
    }
  }
}

Получить информацию о истории

get

Возвращает информацию о истории по его идентификатору.

Authorizations

AuthorizationstringRequired

Bearer‑токен, полученный через vposter.ru/dev. Передаётся в заголовке запроса: Authorization: Bearer <access_token>

Query parameters

idintegerRequired

Идентификатор публикации

Example: 12345

Responses

200

Успешный ответ. Возвращается объект с полем response, содержащим:

items — массив объекта с данными страницы/группы.

application/json

400

Ошибка запроса. Возможные причины:

Токен не передан в заголовке Authorization или параметре access_token
Отсутствуют обязательные заголовки
Некорректный формат параметров

application/json

401

Неавторизованный доступ. Возможные причины:

Токен недействителен или просрочен
Пользователь не найден

application/json

500

Внутренняя ошибка сервера. Возможные причины:

Ошибка базы данных
Проблемы с подключением

application/json

get/v3/method/stories.getById

GET /api/v3/method/stories.getById?id=1 HTTP/1.1
Host: vposter.ru
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "response": {
    "items": [
      {
        "id": 12345,
        "id_group": "67890",
        "name": "Моя группа ВКонтакте",
        "name_autopost": "Рекламный пост (API)",
        "stories_time": 0,
        "photo": "https://pp.vkuserphoto.ru/s/v1/ig2/trWmLifY0iCMeIn7zTkhU...",
        "date_post": "2024-01-15T10:30:00+03:00",
        "post_day": "2024-01-15",
        "stories_link_url": "https://example.com",
        "stories_link_text": "go_to",
        "attachments_json": [
          {
            "type": "photo",
            "id": 457749080,
            "preview": "https://pp.vkuserphoto.ru/s/v1/ig2/SIXJehNSqRY1nyfc7s-fB9-FmQ8LCWaVl-vN0FGIDulCNpQSt_aF-20Rki6dVPsL02v0hWR4b6p5OC6DXtNhZNi9.jpg?quality=95&as=32x57,48x85,72x128,108x192,160x284,240x427,360x640,480x853,540x960,640x1138,720x1280,1080x1920,1280x2276,1440x2560&from=bu&cs=640x0",
            "original": "https://pp.vkuserphoto.ru/s/v1/ig2/SIXJehNSqRY1nyfc7s-fB9-FmQ8LCWaVl-vN0FGIDulCNpQSt_aF-20Rki6dVPsL02v0hWR4b6p5OC6DXtNhZNi9.jpg?quality=95&as=32x57,48x85,72x128,108x192,160x284,240x427,360x640,480x853,540x960,640x1138,720x1280,1080x1920,1280x2276,1440x2560&from=bu",
            "owner_id": 116945277,
            "access_key": "74781521bc8879f57c"
          }
        ],
        "mark_as_ads": 1,
        "del_task": 0,
        "date_task": 0,
        "del_task_date": "2026-02-22",
        "stop_post": 0,
        "stop_post_date": "2026-02-22",
        "delete_sociate": 0,
        "delete_clock": "",
        "delete_minutes": "",
        "status_post": "0",
        "date_create": "2024-01-14T15:23:45+03:00",
        "type_social": "vk",
        "juridical_details": {
          "fio": "Иванов Иван Иванович",
          "inn": "1234567890",
          "kpp": "",
          "stories_summ": "10000.00",
          "type": "physical",
          "flags": [],
          "kktus": [
            "token123"
          ],
          "phone": "+71234567890",
          "person": [
            "advertiser"
          ],
          "foreign": "false",
          "vat_rate": "20",
          "foreign_inn": "",
          "contract_date": "2024-01-01",
          "contract_summ": "10000.00",
          "type_marking": "0",
          "description_ord": "text",
          "contract_serial": "",
          "contract_date_end": "",
          "foreign_epayment_method": "",
          "foreign_oksm_country_code": "",
          "foreign_registration_number": ""
        },
        "text_error": "",
        "status_stories_social": 1,
        "stories_id": 4677
      }
    ]
  }
}

Запланировать публикацию истории

post

Создаёт историю в разделе «Отложенные истории» на указанной странице/группе.

Authorizations

AuthorizationstringRequired

Bearer‑токен, полученный через vposter.ru/dev. Передаётся в заголовке запроса: Authorization: Bearer <access_token>

Body

id_groupstringRequired

Обязательный. ID страницы или группы, куда будет опубликована история. Получается через метод /v3/method/groups.getMy.

Example: 123456

name_autopoststringOptional

Название истории для отображения в запланированных историях (видно только вам).

Example: Рекламная история

stories_timeinteger · enumOptional

Время показа истории:

0 — 24 часа
1 — 1 час
2 — 12 часов
3 — 48 часов

Example: 0Possible values:

type_socialstring · enumRequired

Обязательный. Социальная сеть для публикации:

vk — ВКонтакте
ok — Одноклассники
ig_business — Instagram Business

Example: vkPossible values:

date_poststringOptional

Дата и время публикации. Если не задано, то публикуется через минуту. Формат: ГГГГ-ММ-ДД ЧЧ:ММ

Example: 2025-02-21 15:40

post_daystring · enumRequired

Обязательный. Периодичность публикации (аналогично постам).

Example: onerazPossible values:

stories_imagestringRequired

Обязательный. URL изображения для истории.

Example: https://example.com/image.jpg

stories_link_urlstringOptional

URL для ссылки в истории для vk и ok.

Example: https://example.com

stories_link_textstringOptional

Текст ссылки в истории для vk и ok.

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

to_store — В магазин
more — Еще
book — Забронировать
order — Заказать
enroll — Записаться
fill — Заполнить
signup — Зарегистрироваться
buy — Купить
ticket — Купить билет
write — Написать
open — Открыть
learn_more — Подробнее
view — Посмотреть
go_to — Перейти
contact — Связаться
watch — Смотреть
play — Слушать
install — Установить
read — Читать
vote — Голосовать
congratulate — Поздравить
game — Играть
to_memories_app — К воспоминаниям
calendar — Открыть календарь
watch_clip — Смотреть клип
make_clip — Снять клип
participate — Участвовать
open_mask — Открыть маску
try_on — Примерить
try — Попробовать
profile — Открыть профиль
attach_wall — Открыть запись
attach_article — Читать статью
attach_poll — Открыть опрос
attach_story — Смотреть историю
attach_audio — Слушать
attach_audio_playlist — Открыть плейлист
attach_audio_album — Открыть альбом
attach_video — Смотреть видео
attach_video_live — К трансляции
attach_photo — Открыть фото
attach_album — Открыть фотоальбом
attach_page — Открыть страницу
attach_market — Открыть товар
attach_link — Открыть ссылку
attach_artist — Перейти к музыканту
attach_narrative — Смотреть момент
attach_podcast — Слушать подкаст

Example: go_to

delete_post_datestringOptional

Дата автоматического удаления истории из сервиса (если требуется). Формат: ГГГГ-ММ-ДД

Example: 2025-02-28

delete_clockstringOptional

Час автоматического удаления истории из соцсети (0-4382).

Example: 23

delete_minutesstringOptional

Минута автоматического удаления истории из соцсети (0-59).

Example: 59

stop_post_datestringOptional

Дата автоматического приостановления истории на сервисе (если требуется). Формат: ГГГГ-ММ-ДД

Example: 2025-02-28

del_taskinteger · enumOptional

Удалить историю из сервиса после публикации:

0 — оставить в сервисе
1 — удалить после публикации из сервиса

Example: 0Possible values:

Responses

200

История успешно запланирована. Ответ может содержать идентификатор созданной истории.

application/json

400

Некорректный запрос. Возможные причины:

Токен не передан в заголовке Authorization
Отсутствуют обязательные параметры
Неверный формат данных

application/json

401

Неавторизованный доступ. Возможные причины:

Токен недействителен или просрочен

application/json

409

Место занято. Возможные причины:

История уже запланирована в это время на данной странице.

application/json

429

Достингут лимит постов. Возможные причины:

Одновременно допускается не более 25 историй на одно время на разных страницах.

application/json

500

Внутренняя ошибка сервера. Не удалось создать историю.

application/json

post/v3/method/stories.create

POST /api/v3/method/stories.create HTTP/1.1
Host: vposter.ru
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 959

{
  "id_group": "123456",
  "name_autopost": "Рекламная история",
  "stories_time": 0,
  "type_social": "vk",
  "date_post": "2025-02-21 15:40",
  "post_day": "oneraz",
  "stories_image": "https://example.com/image.jpg",
  "stories_link_url": "https://example.com",
  "stories_link_text": "go_to",
  "delete_post_date": "2025-02-28",
  "delete_clock": "23",
  "delete_minutes": "59",
  "stop_post_date": "2025-02-28",
  "del_task": 0,
  "ads_items": {
    "fio": "Гусманова Регина Таузиховна",
    "inn": "024901056383",
    "kpp": "",
    "stories_summ": "400",
    "type": "ip",
    "flags": [],
    "kktus": [
      "12.1.3"
    ],
    "phone": "",
    "address": "123456, Москва, ул. Льва Толстого, д. 16",
    "person": [
      "advertiser"
    ],
    "foreign": "false",
    "vat_rate": "without_vat",
    "foreign_inn": "",
    "contract_date": "2026-02-19",
    "contract_summ": "400",
    "type_marking": "0",
    "description_ord": "",
    "contract_serial": "",
    "contract_date_end": "",
    "foreign_epayment_method": "",
    "foreign_oksm_country_code": "",
    "foreign_registration_number": ""
  }
}

{
  "response": {
    "stories_id": 12345,
    "created_at": "2026-02-19 20:13:34",
    "type_social": "vk"
  }
}

Отредактировать историю

put

Редактирует историю в разделе «Отложенные истории» на указанной странице/группе.

Authorizations

AuthorizationstringRequired

Bearer‑токен, полученный через vposter.ru/dev. Передаётся в заголовке запроса: Authorization: Bearer <access_token>

Body

idintegerRequired

Обязательный. ID истории на сервисе

Example: 123456

id_groupstringRequired

Example: 123456

name_autopoststringOptional

Название истории для отображения в запланированных историях (видно только вам).

Example: Рекламная история

stories_timeinteger · enumOptional

Время показа истории:

0 — 24 часа
1 — 1 час
2 — 12 часов
3 — 48 часов

Example: 0Possible values:

type_socialstring · enumRequired

Обязательный. Социальная сеть для публикации:

vk — ВКонтакте
ok — Одноклассники
ig_business — Instagram Business

Example: vkPossible values:

date_poststringRequired

Обязательный. Дата и время публикации. Формат: ГГГГ-ММ-ДД ЧЧ:ММ

Example: 2025-02-21 15:40

post_daystring · enumRequired

Обязательный. Периодичность публикации (аналогично постам).

Example: onerazPossible values:

stories_imagestringRequired

Обязательный. URL изображения для истории.

Example: https://example.com/image.jpg

stories_link_urlstringOptional

URL для ссылки в истории для vk и ok.

Example: https://example.com

stories_link_textstringOptional

Текст ссылки в истории для vk и ok.

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

to_store — В магазин
more — Еще
book — Забронировать
order — Заказать
enroll — Записаться
fill — Заполнить
signup — Зарегистрироваться
buy — Купить
ticket — Купить билет
write — Написать
open — Открыть
learn_more — Подробнее
view — Посмотреть
go_to — Перейти
contact — Связаться
watch — Смотреть
play — Слушать
install — Установить
read — Читать
vote — Голосовать
congratulate — Поздравить
game — Играть
to_memories_app — К воспоминаниям
calendar — Открыть календарь
watch_clip — Смотреть клип
make_clip — Снять клип
participate — Участвовать
open_mask — Открыть маску
try_on — Примерить
try — Попробовать
profile — Открыть профиль
attach_wall — Открыть запись
attach_article — Читать статью
attach_poll — Открыть опрос
attach_story — Смотреть историю
attach_audio — Слушать
attach_audio_playlist — Открыть плейлист
attach_audio_album — Открыть альбом
attach_video — Смотреть видео
attach_video_live — К трансляции
attach_photo — Открыть фото
attach_album — Открыть фотоальбом
attach_page — Открыть страницу
attach_market — Открыть товар
attach_link — Открыть ссылку
attach_artist — Перейти к музыканту
attach_narrative — Смотреть момент
attach_podcast — Слушать подкаст

Example: go_to

delete_post_datestringOptional

Дата автоматического удаления истории из сервиса (если требуется). Формат: ГГГГ-ММ-ДД

Example: 2025-02-28

delete_clockstringOptional

Час автоматического удаления истории из соцсети (0-4382).

Example: 23

delete_minutesstringOptional

Минута автоматического удаления истории из соцсети (0-59).

Example: 59

stop_post_datestringOptional

Дата автоматического приостановления истории на сервисе (если требуется). Формат: ГГГГ-ММ-ДД

Example: 2025-02-28

del_taskinteger · enumOptional

Удалить историю из сервиса после публикации:

0 — оставить в сервисе
1 — удалить после публикации из сервиса

Example: 0Possible values:

Responses

200

История успешно отредактирована. Ответ может содержать идентификатор созданной истории.

application/json

400

Некорректный запрос. Возможные причины:

Токен не передан в заголовке Authorization
Отсутствуют обязательные параметры
Неверный формат данных

application/json

401

Неавторизованный доступ. Возможные причины:

Токен недействителен или просрочен

application/json

404

По данному идентификатору история не найдена.

application/json

405

Передан не PUT запрос.

application/json

409

Место занято. Возможные причины:

История уже запланирована в это время на данной странице.

application/json

429

Достингут лимит постов. Возможные причины:

Одновременно допускается не более 25 историй на одно время на разных страницах.

application/json

500

Внутренняя ошибка сервера. Не удалось отредактировать историю.

application/json

put/v3/method/stories.edit

PUT /api/v3/method/stories.edit HTTP/1.1
Host: vposter.ru
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 973

{
  "id": "123456",
  "id_group": "123456",
  "name_autopost": "Рекламная история",
  "stories_time": 0,
  "type_social": "vk",
  "date_post": "2025-02-21 15:40",
  "post_day": "oneraz",
  "stories_image": "https://example.com/image.jpg",
  "stories_link_url": "https://example.com",
  "stories_link_text": "go_to",
  "delete_post_date": "2025-02-28",
  "delete_clock": "23",
  "delete_minutes": "59",
  "stop_post_date": "2025-02-28",
  "del_task": 0,
  "ads_items": {
    "fio": "Гусманова Регина Таузиховна",
    "inn": "024901056383",
    "kpp": "",
    "stories_summ": "400",
    "type": "ip",
    "flags": [],
    "kktus": [
      "12.1.3"
    ],
    "phone": "",
    "address": "123456, Москва, ул. Льва Толстого, д. 16",
    "person": [
      "advertiser"
    ],
    "foreign": "false",
    "vat_rate": "without_vat",
    "foreign_inn": "",
    "contract_date": "2026-02-19",
    "contract_summ": "400",
    "type_marking": "0",
    "description_ord": "",
    "contract_serial": "",
    "contract_date_end": "",
    "foreign_epayment_method": "",
    "foreign_oksm_country_code": "",
    "foreign_registration_number": ""
  }
}

{
  "response": {
    "stories_id": 12345,
    "updated_at": "2026-02-19 20:13:34",
    "type_social": "vk"
  }
}

Удалить историю

delete

Удаляет историю на сервисе.

Authorizations

AuthorizationstringRequired

Bearer‑токен, полученный через vposter.ru/dev. Передаётся в заголовке запроса: Authorization: Bearer <access_token>

Body

idintegerRequired

Обязательный. ID истории на сервисе.

Example: 123456

Responses

200

История успешно удалена.

application/json

400

Некорректный запрос. Возможные причины:

Токен не передан в заголовке Authorization
Отсутствуют обязательные параметры
Неверный формат данных

application/json

401

Неавторизованный доступ. Возможные причины:

Токен недействителен или просрочен

application/json

404

Пост не найден или у вас нет разрешения на доступ к нему.

application/json

500

Внутренняя ошибка сервера. Не удалось удалить историю.

application/json

delete/v3/method/stories.delete

DELETE /api/v3/method/stories.delete HTTP/1.1
Host: vposter.ru
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 13

{
  "id": 123456
}

{
  "response": {
    "success": true,
    "post_id": 123456,
    "deleted_at": "2026-02-19 20:13:34"
  }
}

Приостановить историю

post

Приостанавливает историю на сервисе.

Authorizations

AuthorizationstringRequired

Bearer‑токен, полученный через vposter.ru/dev. Передаётся в заголовке запроса: Authorization: Bearer <access_token>

Body

idintegerRequired

Обязательный. ID отложенной истории на сервисе.

Example: 123456

Responses

200

История успешно приостановлена.

application/json

400

Некорректный запрос. Возможные причины:

Токен не передан в заголовке Authorization
Отсутствуют обязательные параметры
Неверный формат данных

application/json

401

Неавторизованный доступ. Возможные причины:

Токен недействителен или просрочен

application/json

404

История не найдена или у вас нет разрешения на доступ к ней.

application/json

409

История уже приостановлена.

application/json

500

Внутренняя ошибка сервера. Не удалось приостановить историю.

application/json

post/v3/method/stories.pause

POST /api/v3/method/stories.pause HTTP/1.1
Host: vposter.ru
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 13

{
  "id": 123456
}

{
  "response": {
    "success": true,
    "stories_id": 123456,
    "stopped_at": "2026-02-19 20:13:34"
  }
}

Включить историю

post

Включает историю на сервисе.

Authorizations

AuthorizationstringRequired

Bearer‑токен, полученный через vposter.ru/dev. Передаётся в заголовке запроса: Authorization: Bearer <access_token>

Body

idintegerRequired

Обязательный. ID отложенноq историb на сервисе.

Example: 123456

Responses

200

История успешно включена.

application/json

400

Некорректный запрос. Возможные причины:

Токен не передан в заголовке Authorization
Отсутствуют обязательные параметры
Неверный формат данных

application/json

401

Неавторизованный доступ. Возможные причины:

Токен недействителен или просрочен

application/json

404

История не найдена или у вас нет разрешения на доступ к ней.

application/json

409

История уже активирована.

application/json

500

Внутренняя ошибка сервера. Не удалось включить историю.

application/json

post/v3/method/stories.resume

POST /api/v3/method/stories.resume HTTP/1.1
Host: vposter.ru
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 13

{
  "id": 123456
}

{
  "response": {
    "success": true,
    "stories_id": 123456,
    "activated_at": "2026-02-19 20:13:34"
  }
}

Получение списка ККТУ (Классификатор товаров и услуг)

get

Возвращает список ККТУ с возможностью фильтрации по названию и коду. Метод работает с GET запросами. Все параметры передаются в query string.

Authorizations

AuthorizationstringRequired

Bearer‑токен, полученный через vposter.ru/dev. Передаётся в заголовке запроса: Authorization: Bearer <access_token>

Query parameters

searchstringOptional

Поиск по названию (регистронезависимый)

Example: магазин

qstringOptional

Альтернативный параметр для поиска по названию

Example: одежда

codestringOptional

Фильтр по началу кода

Example: 10.

pageinteger · min: 1Optional

Номер страницы для пагинации

Default: 1Example: 1

per_pageinteger · min: 1 · max: 1000Optional

Количество элементов на странице

Default: 50Example: 20

Responses

200

Успешный ответ

application/json

successbooleanOptionalExample: true

countintegerOptionalExample: 1

400

Неверный запрос

application/json

401

Ошибка авторизации

application/json

405

Метод не разрешен

application/json

500

Внутренняя ошибка сервера

application/json

get/v3/method/dictionary.getKktu

GET /api/v3/method/dictionary.getKktu HTTP/1.1
Host: vposter.ru
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "success": true,
  "count": 1,
  "items": [
    {
      "code": "1.1.1",
      "name": "Вино"
    }
  ],
  "pagination": {
    "page": 1,
    "per_page": 1,
    "total": 294,
    "total_pages": 294
  }
}

Получение списка стран (ОКСМ - Общероссийский классификатор стран мира)

get

Возвращает список стран по классификатору ОКСМ с возможностью фильтрации. Данные загружаются из внешнего источника и содержат коды стран и их названия. Метод работает с GET запросами. Все параметры передаются в query string.

Authorizations

AuthorizationstringRequired

Bearer‑токен, полученный через vposter.ru/dev. Передаётся в заголовке запроса: Authorization: Bearer <access_token>

Query parameters

searchstringOptional

Поиск по названию страны или коду (регистронезависимый)

Example: Грузия

qstringOptional

Альтернативный параметр для поиска по названию или коду

Example: Беларусь

idstringOptional

Фильтр по точному коду страны (трехзначный цифровой код)

Example: 112

idsstringOptional

Фильтр по нескольким кодам стран (через запятую)

Example: 112,268

pageinteger · min: 1Optional

Номер страницы для пагинации

Default: 1Example: 1

per_pageinteger · min: 1 · max: 1000Optional

Количество элементов на странице

Default: 50Example: 20

Responses

200

Успешный ответ

application/json

400

Неверный запрос

application/json

401

Ошибка авторизации

application/json

405

Метод не разрешен

application/json

500

Внутренняя ошибка сервера

application/json

get/v3/method/dictionary.getCountries

GET /api/v3/method/dictionary.getCountries HTTP/1.1
Host: vposter.ru
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "response": {
    "count": 2,
    "items": [
      {
        "id": "112",
        "value": "Беларусь"
      },
      {
        "id": "268",
        "value": "Грузия"
      }
    ],
    "pagination": {
      "page": 1,
      "per_page": 100,
      "total": 2,
      "total_pages": 1
    },
    "filters": {
      "ids": "112,268"
    }
  }
}

ПредыдущаяОбучающие материалы

Последнее обновление 6 месяцев назад

Это было полезно?