VPVP

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

API позволяет публиковать посты в подключённые каналы из вашей системы — без входа в кабинет. Доступен на тарифе «Маркетолог» и на индивидуальном тарифе. Каналы подключаются в кабинете, через API их только выбирают.

Что такое ключ и где его взять

Ключ — секретная строка вида vpk_…, по которой API узнаёт, что запрос от вас. Создать ключ: в кабинете Настройки → API → «Создать ключ» (это может владелец или администратор кабинета). Ключ показывается один раз, сразу после создания, — сохраните его в надёжном месте: посмотреть его ещё раз нельзя, только создать новый. Активных ключей — не больше 5. Там же ключ отзывают: отозванный перестаёт работать сразу, а отложенные посты, созданные этим ключом и ещё не отправленные, отменяются.

Если на странице Настройки → API написано, что API недоступен, — текущий тариф его не включает. Сменить тариф: Настройки → Подписка.

Авторизация

Каждый запрос — с заголовком Authorization:

Authorization: Bearer vpk_ваш_ключ

Без ключа, с неверным или отозванным ключом ответ одинаковый — 401:

{"error": "invalid_api_key", "message": "Неверный или отозванный ключ API."}

После 20 неудачных попыток с одного IP за 10 минут неудачные запросы с него получают 429; запросы с верным ключом проходят и дальше.

Эндпоинты

Базовый адрес: https://api.vproksmm.ru/api/v1. Тела запросов и ответов — JSON (кроме загрузки фото), время — ISO 8601 с часовым поясом.

GET/channels

Каналы, подключённые в кабинете

Запрос
curl "https://api.vproksmm.ru/api/v1/channels" \
  -H "Authorization: Bearer vpk_ваш_ключ"
Ответ 200
[
  {"id": 101, "type": "telegram", "title": "Мой канал", "status": "connected", "active": true},
  {"id": 102, "type": "vk", "title": "Моя группа", "status": "connected", "active": true},
  {"id": 103, "type": "ok", "title": "Одноклассники", "status": "expired", "active": false}
]

active: true — канал подключён, публикация в него включена и он есть в тарифе: туда уходят посты, если не указать channel_ids. status — состояние подключения: connected — всё в порядке, другое значение (например, expired) — канал нужно заново подключить в кабинете (Настройки → Каналы).

POST/photos

Загрузить фото для поста

Один файл в поле file (multipart/form-data): JPEG, PNG или WebP до 5 МБ. Полученный photo_id передайте в photo_ids при создании поста. Он годится 24 часа и на один пост.

Запрос
curl "https://api.vproksmm.ru/api/v1/photos" \
  -H "Authorization: Bearer vpk_ваш_ключ" \
  -F "file=@/путь/к/фото.jpg"
Ответ 200
{"photo_id": "9f1c2b7e4a5d4c3b8e6f0a1b2c3d4e5f", "width": 1280, "height": 960}

Ограничения: не больше 40 загрузок в час на кабинет (вместе с загрузками в самом кабинете) и не больше 30 загруженных, но ещё не приложенных к посту фото — при 31-й самая старая удаляется, и её photo_id даст ошибку. Поэтому порядок такой: загрузили фото поста → сразу создали пост. Ошибки: 400 — не тот формат или файл не фото, 413 — больше 5 МБ, 429 — лимит загрузок (заголовок Retry-After).

POST/videos

Загрузить видео для поста или истории

Один файл в поле file (multipart/form-data): MP4 — видео H.264, звук AAC (или без звука), до 10 МБ. Формат проверяем по содержимому файла, а не по имени. Полученный video_id передайте в video_id при создании поста. Он годится 24 часа и на один пост.

Запрос
curl "https://api.vproksmm.ru/api/v1/videos" \
  -H "Authorization: Bearer vpk_ваш_ключ" \
  -F "file=@/путь/к/ролику.mp4"
Ответ 200
{"video_id": "4b7d1e9a0c2f4e6a8b1d3f5a7c9e0b2d", "duration_sec": 12.4}

Для истории ВКонтакте ролик должен быть не длиннее 15 секунд (лучше вертикальный 9:16). Лимит загрузок общий с фото: 40 в час на кабинет; загруженных и ещё не приложенных видео держим не больше 10. Ошибки: 400 — не MP4 (H.264/AAC), файл повреждён или длиннее 10 минут, 413 — больше 10 МБ, 429 — лимит загрузок (заголовок Retry-After).

POST/posts

Создать пост

Источник текста — ровно один: text или url (ссылка на материал — текст возьмём со страницы). Пост с фото — это text (подпись) + photo_ids + photos_rights: true. Тело запроса — не больше 64 КБ.

ПолеОписание
textТекст поста или подпись к фото, до 5000 символов.
urlСсылка http(s) на материал — вместо text.
titleЗаголовок, до 300 символов. Необязательно.
photo_idsДо 10 id из POST /photos, по порядку; первое фото — обложка.
photos_rightstrue — подтверждаю, что фото мои и у меня есть права на публикацию. Обязательно, если есть photo_ids, иначе 422 invalid_photo.
video_idid из POST /videos — вместо photo_ids (вместе с фото — 422 video_with_photos). Обычный пост: ролик уйдёт в каналы, которые публикуют видео (Telegram, MAX, ВКонтакте, TenChat, LinkedIn, Instagram, TikTok, YouTube, Rutube); остальные каналы получат пост с картинкой. История (format: "story"): ролик истории ВКонтакте, до 15 секунд — иначе 422 story_video_invalid.
channel_idsКаналы — id из GET /channels. Без поля — все каналы с active: true. Чужой или неизвестный id — 422 unknown_channel, канал с публикацией выключенной — 422 channel_not_active.
modeadapt (по умолчанию) — ИИ пишет текст под каждую площадку; as_is — публикуем ваш текст как есть.
publish_atКогда опубликовать: ISO 8601 с часовым поясом, не раньше текущего момента и не позже чем через 30 дней. Без поля — сразу. Отложенный пост до publish_at можно отменить — DELETE /posts/{id}; в кабинете («Посты») он появится в момент публикации.
formatpost (по умолчанию) — обычный пост; story — история ВКонтакте вместо поста на стене. Только каналы vk: без channel_ids — все активные каналы ВКонтакте, канал другой площадки — 422 story_not_supported.
Запрос — текстом, сразу
curl "https://api.vproksmm.ru/api/v1/posts" \
  -H "Authorization: Bearer vpk_ваш_ключ" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: order-4471" \
  -d '{
    "text": "Открыли новый офис в Казани!",
    "channel_ids": [101, 102]
  }'
Запрос — по ссылке, отложенный
curl "https://api.vproksmm.ru/api/v1/posts" \
  -H "Authorization: Bearer vpk_ваш_ключ" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com/news/123",
    "publish_at": "2026-11-23T09:00:00+03:00"
  }'
Запрос — с фото
curl "https://api.vproksmm.ru/api/v1/posts" \
  -H "Authorization: Bearer vpk_ваш_ключ" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Новая коллекция уже в магазинах",
    "photo_ids": ["9f1c2b7e4a5d4c3b8e6f0a1b2c3d4e5f"],
    "photos_rights": true,
    "mode": "as_is"
  }'
Запрос — история ВКонтакте
curl "https://api.vproksmm.ru/api/v1/posts" \
  -H "Authorization: Bearer vpk_ваш_ключ" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: story-4472" \
  -d '{
    "format": "story",
    "text": "Распродажа до воскресенья",
    "photo_ids": ["9f1c2b7e4a5d4c3b8e6f0a1b2c3d4e5f"],
    "photos_rights": true,
    "channel_ids": [102]
  }'
Запрос — история ВКонтакте с видео
curl "https://api.vproksmm.ru/api/v1/posts" \
  -H "Authorization: Bearer vpk_ваш_ключ" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: story-4473" \
  -d '{
    "format": "story",
    "text": "Распродажа до воскресенья",
    "video_id": "4b7d1e9a0c2f4e6a8b1d3f5a7c9e0b2d",
    "channel_ids": [102]
  }'

История — это ролик из video_id (MP4 до 15 секунд и до 10 МБ) или первое фото из photo_ids (JPG или PNG, до 10 МБ, лучше вертикальное 9:16, 1080×1920). Без них соберём вертикальную карточку из text. Подписи у истории ВКонтакте нет — текст нужен только для карточки. История считается одной публикацией в месячном лимите, Idempotency-Key работает так же, как у поста. Когда история выйдет, в GET /posts/{id} у канала будут external_url (ссылка на историю) и external_id — id истории вида -123456789_456239017.

Ответ 202
{
  "id": 88341,
  "status": "queued",
  "publish_at": null,
  "channels": [101, 102]
}

status: queued — пост принят и уходит в работу сразу, scheduled — отложен до publish_at (в ответе — в UTC). channels — каналы, в которые он уйдёт. Ход публикации — в GET /posts/{id}.

GET/posts/{id}

Статус поста по каналам

Запрос
curl "https://api.vproksmm.ru/api/v1/posts/88341" \
  -H "Authorization: Bearer vpk_ваш_ключ"
Ответ 200 — в одном канале уже вышел, в другом ещё идёт
{
  "id": 88341,
  "status": "processing",
  "publish_at": null,
  "created_at": "2026-10-06T12:01:00Z",
  "channels": [
    {
      "channel_id": 101,
      "type": "telegram",
      "status": "published",
      "external_url": "https://t.me/mychannel/412",
      "external_id": "412",
      "error": null
    },
    {
      "channel_id": 102,
      "type": "vk",
      "status": "pending",
      "external_url": null,
      "external_id": null,
      "error": null
    }
  ]
}

Статус поста (status). Конечные — published, partially_published и failed: дальше не меняются, опрашивать больше не нужно.

statusЧто значит
scheduledЖдёт publish_at. Отменить — DELETE /posts/{id}.
queuedПринят, публикация ещё не началась.
processingИдёт публикация: часть каналов может быть уже опубликована. У Rutube длинный ролик обрабатывается до 24 часов — всё это время канал pending, а пост processing; повторно пост не отправляйте, итог придёт сам.
publishedВышел во всех выбранных каналах.
partially_publishedВышел в части каналов; по остальным — error.
failedНе вышел ни в один канал; причина — в error каналов.

Статус канала (channels[].status): pending — ещё не опубликован; published — опубликован, external_url — ссылка на пост; failed — площадка не приняла пост; skipped — до канала публикация не дошла. Для failed и skipped в error — код причины:

errorЧто случилось и что сделать
token_expired, token_revoked, cookies_expiredВход в аккаунт площадки устарел — заново подключите канал: Настройки → Каналы.
captcha_required, page_mode_required, group_not_memberПлощадка просит действие в браузере — откройте канал в кабинете, там подсказка.
vc_monthly_limitИсчерпан месячный лимит публикаций vc.ru.
vk_story_reconnectВКонтакте не дал прав на истории сообщества — переподключите ВКонтакте (вход делает администратор сообщества): Настройки → Каналы.
story_media_invalidФото не подходит для истории ВКонтакте: JPG/PNG до 10 МБ, не уже 1:20.
story_publish_failedВКонтакте не принял историю. Посты на стену это не затрагивает — можно повторить запрос с новым Idempotency-Key.
video_rejectedRutube не принял ролик: не смог скачать файл или ролик удалён на Rutube. Пост можно отправить заново — POST /posts/{id}/retry.
publish_failed и другие коды площадокПлощадка не приняла пост. Проверьте канал: Настройки → Каналы → «Проверить канал».
monthly_capИсчерпан месячный лимит публикаций.
subscription_expired, trial_unverified, trial_exhaustedПодписка закончилась или ограничения пробного периода — Настройки → Подписка.
no_channelsПубликовать было некуда: нет активного канала.
intl_not_in_tier, vc_monthly_capКаналы отсекли правила тарифа или площадки.
content_blockedПроверка безопасности не пропустила текст.
writers_failed, internal_error, interruptedСбой на нашей стороне или публикация прервалась. Проверьте ленты каналов; поста нет — создайте его заново.
not_publishedПост вышел, а этот канал отсекли правила тарифа или площадки.
not_sentПубликация не началась за 6 часов — создайте пост заново.

Чужой или несуществующий пост — 404 not_found, одинаково для обоих случаев. Статус поста хранится 90 дней после создания.

POST/posts/{id}/retry

Опубликовать повторно — в каналы, где публикация не прошла

Запрос
curl -X POST "https://api.vproksmm.ru/api/v1/posts/88341/retry" \
  -H "Authorization: Bearer vpk_ваш_ключ" \
  -H "Idempotency-Key: retry-88341-2"
Ответ 202
{
  "id": 88341,
  "status": "processing",
  "publish_at": null,
  "created_at": "2026-10-06T12:01:00Z",
  "channels": [
    {"channel_id": 101, "type": "telegram", "status": "published", "external_url": "https://t.me/mychannel/412", "external_id": "412", "error": null},
    {"channel_id": 102, "type": "vk", "status": "pending", "external_url": null, "external_id": null, "error": null}
  ],
  "retry": {
    "channels": [{"channel_id": 102, "type": "vk"}],
    "skipped": [
      {"channel_id": 101, "type": "telegram", "code": "already_published", "message": "…"}
    ]
  }
}

Тот же пост — те же тексты и медиа, без новой генерации — уходит только в каналы этого поста, куда он точно не дошёл: площадка отказала до публикации или до канала не дошли. Каналы, где пост уже вышел, не трогаем; пост старше 14 дней не повторяем (409 post_too_old). Повтор — не новая публикация по тарифу: место в месячном лимите пост занимает один раз (если он ещё не вышел никуда, место спишется, когда повтор выйдет хотя бы в один канал). Ответ 202 — как у GET /posts/{id} (статус processing, каналы повтора — pending) плюс поле retry: channels — куда ушёл повтор, skipped — каналы без повтора с причиной (code, message). Итог смотрите в GET /posts/{id}: статус канала — по последней попытке.

code в skippedЧто значит
already_publishedВ канале пост уже вышел.
maybe_publishedПост мог выйти: площадка не подтвердила публикацию, оборвался ответ или часть поста уже в канале. Проверьте канал — сами такой канал не повторяем, чтобы не было дубля.
channel_inactiveПубликация в канал выключена в кабинете — туда не повторяем.
channel_pausedКанал на паузе после нескольких сбоев подряд — сервис сам попробует его позже.
channel_disconnected, channel_disabled, channel_missingКанал не подключён, выключен или удалён — переподключите его в кабинете (Настройки → Каналы).
no_textУ поста нет текста для этого канала — создайте пост заново.
media_missingФайлы поста (видео или фото) уже удалены — создайте пост заново.
intl_not_in_tier, vc_monthly_capКанал отсекли правила тарифа или месячный лимит vc.ru.
tiktok_confirmTikTok ждёт подтверждения публикации в кабинете.
platform_processingRutube ещё обрабатывает ролик (до 24 часов) — итог канала придёт сам, повтор дал бы дубль.

Повторять нечего — 409 nothing_to_retry (причины по каналам — в skipped, у этих ответов поле есть всегда); публикация поста ещё идёт — 409 retry_in_progress; у аккаунта уже идут три повтора — 429 rate_limited с retry_after. Idempotency-Key — на одну попытку повтора: с прежним ключом 24 часа вернётся прежний ответ и повтор не запустится, поэтому каждый следующий повтор того же поста отправляйте с новым ключом. Повтор можно запустить и из кабинета (кнопка «Опубликовать повторно» в «Посты») — тогда GET /posts/{id} тоже снова покажет processing.

DELETE/posts/{id}

Отменить отложенный пост

Запрос
curl -X DELETE "https://api.vproksmm.ru/api/v1/posts/88342" \
  -H "Authorization: Bearer vpk_ваш_ключ"
Ответ 200
{"id": 88342, "status": "cancelled"}

Только для поста со статусом scheduled (до publish_at): он не выйдет, место в месячном лимите освобождается, дальше GET /posts/{id} отвечает 404. Пост, который уже отправлен в публикацию (queued и дальше), не отменяется — 409 not_scheduled. Отзыв ключа в кабинете отменяет все отложенные посты этого ключа. Пересоздаёте пост после отмены — с новым Idempotency-Key: повтор со старым в течение 24 часов вернёт прежний ответ (id отменённого поста).

GET/posts

Посты, созданные через API (новые сверху)

Запрос
curl "https://api.vproksmm.ru/api/v1/posts?limit=20" \
  -H "Authorization: Bearer vpk_ваш_ключ"
Ответ 200
{
  "items": [
    {"id": 88341, "status": "published", "publish_at": null, "created_at": "…", "channels": […]}
  ],
  "next_cursor": 88340
}

Элемент items — как ответ GET /posts/{id}. limit — от 1 до 50 (по умолчанию 20). Следующая страница — ?cursor= со значением next_cursor; next_cursor: null — страниц больше нет.

Ошибки

Любая ошибка — JSON {"error": "<код>", "message": "<текст>"}; у 422 validation_error есть ещё details — список полей с ошибками, у 402 monthly_limit_reached — limit, used и in_progress. Решайте по полю error, текст в message может меняться. Исключение — файл больше 5 МБ: такой запрос веб-сервер может отклонить сам, ответом 413 не в JSON.

Чтобы получать message по-английски, передавайте заголовок Accept-Language: en (поле error и статус от языка не зависят).

HTTPerrorКогда
400bad_requestФото: не тот формат, файл не фото или файлов не один.
401invalid_api_keyКлюча нет, он неверный или отозван.
402monthly_limit_reachedМесячный лимит исчерпан (с учётом постов в очереди и отложенных).
402brand_frozenБренд заморожен — ключ не действует, пока бренд не разморозят в кабинете корня.
402subscription_expiredПодписка закончилась.
402trial_unverified, trial_exhaustedПробный период: контакт не подтверждён или пробные публикации закончились.
403api_not_availableТариф не включает API.
403account_closedКабинет удалён или заблокирован — ключ не действует.
403key_author_inactiveАвтор ключа удалён из кабинета или лишён прав редактирования — ключ не действует, создайте новый.
404not_foundПоста нет (или он чужой), либо такого адреса в API нет.
405method_not_allowedНе тот метод для этого адреса.
409idempotency_key_reusedIdempotency-Key уже был с другим телом запроса.
409idempotency_in_progressЗапрос с этим Idempotency-Key ещё выполняется.
409nothing_to_retryPOST /posts/{id}/retry: повторять некуда — причины по каналам в skipped.
409retry_in_progressPOST /posts/{id}/retry: публикация этого поста ещё идёт.
409post_too_oldPOST /posts/{id}/retry: пост старше 14 дней — создайте его заново.
409not_scheduledDELETE /posts/{id}: пост уже отправлен в публикацию — отменить нельзя.
411length_requiredНет заголовка Content-Length.
413payload_too_largeТело запроса больше 64 КБ, фото больше 5 МБ, видео больше 10 МБ.
422validation_errorПоля запроса не те: подробности в details.
422unknown_channelВ channel_ids чужой или неизвестный канал.
422channel_not_activeКанал не подключён или публикация в него выключена.
422no_channelsНет ни одного активного канала (или channel_ids пуст).
422story_not_supportedformat=story, а в channel_ids есть не ВКонтакте: истории — только во ВКонтакте.
422invalid_photoФото не найдено (чужое, уже приложено, истекло) или нет photos_rights.
422invalid_videoВидео не найдено (чужое, уже приложено к посту, истекло — загрузите заново).
422video_with_photosВ посте и video_id, и photo_ids — нужно что-то одно.
422story_video_invalidformat=story, а ролик не подходит для истории ВКонтакте (длиннее 15 секунд).
422invalid_publish_atpublish_at в прошлом или дальше 30 дней.
422url_fetch_failedНе удалось взять текст со страницы по url.
422invalid_contentТекст пустой после очистки.
429rate_limitedСлишком часто — подождите столько секунд, сколько в Retry-After.
500internal_errorСбой на нашей стороне — повторите позже.
503retry_unavailablePOST /posts/{id}/retry: очередь недоступна — повторите через минуту.

Лимиты

Идемпотентность

Если ваша система может повторить запрос (например, после обрыва связи), передайте в POST /posts заголовок Idempotency-Key: латинские буквы, цифры и знаки без пробелов, до 128 символов (номер заказа, UUID). Повтор с тем же ключом и тем же телом в течение 24 часов вернёт тот же ответ (с заголовком Idempotent-Replayed: true) и второго поста не создаст — даже если два запроса пришли одновременно. Тот же ключ с другим телом — 409 idempotency_key_reused.

Часовые пояса

Время передавайте в ISO 8601 с часовым поясом, например 2026-11-23T09:00:00+03:00 (09:00 по Москве); без пояса запрос не примется. publish_at — не раньше текущего момента и не позже чем через 30 дней; время, которое уже наступило (до минуты назад), означает «сразу». В ответах время — в UTC.

Схема OpenAPI

Машиночитаемое описание всех эндпоинтов — https://api.vproksmm.ru/api/v1/openapi.json.