Справочник REST API

Автоматизируйте публикации и получайте аналитику программно. Базовый URL: https://vedismm.ru/api/v1

Авторизация

Создайте персональный токен в разделе «API и токены» и передавайте его в заголовке:

Authorization: Bearer vsmm_ваш_токен

Лимит запросов — 120 в минуту на токен. Заголовки X-RateLimit-Remaining показывают остаток.

Формат ответа

Успех — объект data (и опционально meta). Ошибка — объект error:

{ "data": { ... }, "meta": { "page": 1 } }
{ "error": { "message": "Пост не найден.", "code": 404 } }

Эндпоинты

Метод	Путь	Описание
GET	/api/v1/ping	Проверка доступности и авторизации.
GET	/api/v1/me	Данные текущего пользователя.
GET	/api/v1/accounts	Список подключённых аккаунтов.
GET	/api/v1/groups	Группы аккаунтов.
GET	/api/v1/networks	Поддерживаемые соцсети и их лимиты.
GET	/api/v1/posts	Список постов. Параметры: status, page, limit.
POST	/api/v1/posts	Создать пост. Параметры: content, link, title, account_ids[], media_ids[], action (draft\|schedule\|publish), scheduled_at
GET	/api/v1/posts/{id}	Получить пост с целями и медиа.
POST	/api/v1/posts/{id}/publish	Опубликовать пост немедленно.
DELETE	/api/v1/posts/{id}	Удалить пост.
GET	/api/v1/media	Медиатека пользователя.
POST	/api/v1/media	Загрузить файл (multipart/form-data, поле file).
GET	/api/v1/analytics	Аналитика. Параметр range = 7\|30\|90.

Пример: создание запланированного поста

curl -X POST https://vedismm.ru/api/v1/posts \
  -H "Authorization: Bearer vsmm_ваш_токен" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "Привет из API! 🚀",
    "account_ids": [12, 15],
    "action": "schedule",
    "scheduled_at": "2026-08-01T10:00:00"
  }'

Пример: загрузка изображения

curl -X POST https://vedismm.ru/api/v1/media \
  -H "Authorization: Bearer vsmm_ваш_токен" \
  -F "file=@/path/to/image.jpg"

Полученный id передайте в media_ids при создании поста.

Создать токен