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 с часовым поясом.
/channelsКаналы, подключённые в кабинете
curl "https://api.vproksmm.ru/api/v1/channels" \
-H "Authorization: Bearer vpk_ваш_ключ"[
{"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) — канал нужно заново подключить в кабинете (Настройки → Каналы).
/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"{"photo_id": "9f1c2b7e4a5d4c3b8e6f0a1b2c3d4e5f", "width": 1280, "height": 960}Ограничения: не больше 40 загрузок в час на кабинет (вместе с загрузками в самом кабинете) и не больше 30 загруженных, но ещё не приложенных к посту фото — при 31-й самая старая удаляется, и её photo_id даст ошибку. Поэтому порядок такой: загрузили фото поста → сразу создали пост. Ошибки: 400 — не тот формат или файл не фото, 413 — больше 5 МБ, 429 — лимит загрузок (заголовок Retry-After).
/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"{"video_id": "4b7d1e9a0c2f4e6a8b1d3f5a7c9e0b2d", "duration_sec": 12.4}Для истории ВКонтакте ролик должен быть не длиннее 15 секунд (лучше вертикальный 9:16). Лимит загрузок общий с фото: 40 в час на кабинет; загруженных и ещё не приложенных видео держим не больше 10. Ошибки: 400 — не MP4 (H.264/AAC), файл повреждён или длиннее 10 минут, 413 — больше 10 МБ, 429 — лимит загрузок (заголовок Retry-After).
/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_rights | true — подтверждаю, что фото мои и у меня есть права на публикацию. Обязательно, если есть photo_ids, иначе 422 invalid_photo. |
| video_id | id из 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. |
| mode | adapt (по умолчанию) — ИИ пишет текст под каждую площадку; as_is — публикуем ваш текст как есть. |
| publish_at | Когда опубликовать: ISO 8601 с часовым поясом, не раньше текущего момента и не позже чем через 30 дней. Без поля — сразу. Отложенный пост до publish_at можно отменить — DELETE /posts/{id}; в кабинете («Посты») он появится в момент публикации. |
| format | post (по умолчанию) — обычный пост; 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.
{
"id": 88341,
"status": "queued",
"publish_at": null,
"channels": [101, 102]
}status: queued — пост принят и уходит в работу сразу, scheduled — отложен до publish_at (в ответе — в UTC). channels — каналы, в которые он уйдёт. Ход публикации — в GET /posts/{id}.
/posts/{id}Статус поста по каналам
curl "https://api.vproksmm.ru/api/v1/posts/88341" \
-H "Authorization: Bearer vpk_ваш_ключ"{
"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_rejected | Rutube не принял ролик: не смог скачать файл или ролик удалён на 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 дней после создания.
/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"{
"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_confirm | TikTok ждёт подтверждения публикации в кабинете. |
| platform_processing | Rutube ещё обрабатывает ролик (до 24 часов) — итог канала придёт сам, повтор дал бы дубль. |
Повторять нечего — 409 nothing_to_retry (причины по каналам — в skipped, у этих ответов поле есть всегда); публикация поста ещё идёт — 409 retry_in_progress; у аккаунта уже идут три повтора — 429 rate_limited с retry_after. Idempotency-Key — на одну попытку повтора: с прежним ключом 24 часа вернётся прежний ответ и повтор не запустится, поэтому каждый следующий повтор того же поста отправляйте с новым ключом. Повтор можно запустить и из кабинета (кнопка «Опубликовать повторно» в «Посты») — тогда GET /posts/{id} тоже снова покажет processing.
/posts/{id}Отменить отложенный пост
curl -X DELETE "https://api.vproksmm.ru/api/v1/posts/88342" \
-H "Authorization: Bearer vpk_ваш_ключ"{"id": 88342, "status": "cancelled"}Только для поста со статусом scheduled (до publish_at): он не выйдет, место в месячном лимите освобождается, дальше GET /posts/{id} отвечает 404. Пост, который уже отправлен в публикацию (queued и дальше), не отменяется — 409 not_scheduled. Отзыв ключа в кабинете отменяет все отложенные посты этого ключа. Пересоздаёте пост после отмены — с новым Idempotency-Key: повтор со старым в течение 24 часов вернёт прежний ответ (id отменённого поста).
/postsПосты, созданные через API (новые сверху)
curl "https://api.vproksmm.ru/api/v1/posts?limit=20" \
-H "Authorization: Bearer vpk_ваш_ключ"{
"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 и статус от языка не зависят).
| HTTP | error | Когда |
|---|---|---|
| 400 | bad_request | Фото: не тот формат, файл не фото или файлов не один. |
| 401 | invalid_api_key | Ключа нет, он неверный или отозван. |
| 402 | monthly_limit_reached | Месячный лимит исчерпан (с учётом постов в очереди и отложенных). |
| 402 | brand_frozen | Бренд заморожен — ключ не действует, пока бренд не разморозят в кабинете корня. |
| 402 | subscription_expired | Подписка закончилась. |
| 402 | trial_unverified, trial_exhausted | Пробный период: контакт не подтверждён или пробные публикации закончились. |
| 403 | api_not_available | Тариф не включает API. |
| 403 | account_closed | Кабинет удалён или заблокирован — ключ не действует. |
| 403 | key_author_inactive | Автор ключа удалён из кабинета или лишён прав редактирования — ключ не действует, создайте новый. |
| 404 | not_found | Поста нет (или он чужой), либо такого адреса в API нет. |
| 405 | method_not_allowed | Не тот метод для этого адреса. |
| 409 | idempotency_key_reused | Idempotency-Key уже был с другим телом запроса. |
| 409 | idempotency_in_progress | Запрос с этим Idempotency-Key ещё выполняется. |
| 409 | nothing_to_retry | POST /posts/{id}/retry: повторять некуда — причины по каналам в skipped. |
| 409 | retry_in_progress | POST /posts/{id}/retry: публикация этого поста ещё идёт. |
| 409 | post_too_old | POST /posts/{id}/retry: пост старше 14 дней — создайте его заново. |
| 409 | not_scheduled | DELETE /posts/{id}: пост уже отправлен в публикацию — отменить нельзя. |
| 411 | length_required | Нет заголовка Content-Length. |
| 413 | payload_too_large | Тело запроса больше 64 КБ, фото больше 5 МБ, видео больше 10 МБ. |
| 422 | validation_error | Поля запроса не те: подробности в details. |
| 422 | unknown_channel | В channel_ids чужой или неизвестный канал. |
| 422 | channel_not_active | Канал не подключён или публикация в него выключена. |
| 422 | no_channels | Нет ни одного активного канала (или channel_ids пуст). |
| 422 | story_not_supported | format=story, а в channel_ids есть не ВКонтакте: истории — только во ВКонтакте. |
| 422 | invalid_photo | Фото не найдено (чужое, уже приложено, истекло) или нет photos_rights. |
| 422 | invalid_video | Видео не найдено (чужое, уже приложено к посту, истекло — загрузите заново). |
| 422 | video_with_photos | В посте и video_id, и photo_ids — нужно что-то одно. |
| 422 | story_video_invalid | format=story, а ролик не подходит для истории ВКонтакте (длиннее 15 секунд). |
| 422 | invalid_publish_at | publish_at в прошлом или дальше 30 дней. |
| 422 | url_fetch_failed | Не удалось взять текст со страницы по url. |
| 422 | invalid_content | Текст пустой после очистки. |
| 429 | rate_limited | Слишком часто — подождите столько секунд, сколько в Retry-After. |
| 500 | internal_error | Сбой на нашей стороне — повторите позже. |
| 503 | retry_unavailable | POST /posts/{id}/retry: очередь недоступна — повторите через минуту. |
POST и DELETE и до 120 запросов GET в минуту. Больше — 429 с заголовком Retry-After (секунды).Если ваша система может повторить запрос (например, после обрыва связи), передайте в 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.
Машиночитаемое описание всех эндпоинтов — https://api.vproksmm.ru/api/v1/openapi.json.