create.stories
Метод доступен с помощью ключа доступа access_token
Данный метод позволяет создать запланированную историю в разделе Отложенные истории.
Для использования метода сообщество должно быть подключено к отложенным историям!
Обязательные параметры:
Параметр
Описание
id_group (integer) Обязательный параметр
Идентификатор сообщества ВКонтакте, в котором должна быть опубликована история.
name (string) Обязательный параметр
Название сообщества для отображения в запланированных историях
name_autopost
(string)
Необязательный параметр
Название истории для отображения в запланированных историях
stories_time
(integer)
Необязательный параметр
Время показа истории
0 - 24 часа
1 - 1 час
2 - 12 часов
3 - 48 часов
По умолчанию 24 часа.
photo (string) Обязательный параметр
Аватар для отображения в запланированных историях
date_post (string) Обязательный параметр
Дата публикации истории
Пример:
2025-02-21 15:40
post_day (string) Обязательный параметр
Режим публикаций
oneraz - на один раз
everyday - каждый день
budday - будние дни (кроме сб. и вс.)
weekends - выходные дни (сб. и вс.)
every2day - раз в 2 дня
every3day - раз в 3 дня
every4day - раз в 4 дня
every5day - раз в 5 дней
every6day - раз в 6 дней
everyweek - каждую неделю
every8day - раз в 8 дней
every9day - раз в 9 дней
every10day - раз в 10 дней
every11day - раз в 11 дней
every12day - раз в 12 дней
every13day - раз в 13 дней
every2week - каждые 2 недели
every3week - каждые 3 недели
everymonth - каждый месяц
every2month - каждые 2 месяца
every3month - каждые 3 месяца
every4month - каждые 4 месяца
every5month - каждые 5 месяцев
every6month - каждые 6 месяцев
every7month - каждые 7 месяцев
every8month - каждые 8 месяцев
every9month - каждые 9 месяцев
every10month - каждые 10 месяцев
every11month - каждые 11 месяцев
every12month - каждый год
delete_post_date (string) Необязательный параметр
Удаление задания в конкретную дату (удаления истории из запланированных историй Впостера).
Пример:
2025-02-28
stop_post_date (string) Необязательный параметр
Удаление задания в конкретную дату (удаления истории из запланированных историй Впостера).
Пример:
2025-02-28
mark_as_ads
(checkbox)
Не обязательный параметр
1 — у истории будет добавлена метка Реклама от автора, 0 — метки добавлено не будет.
del_task (checkbox) Не обязательный параметр
1 — удалить историю после публикации из запланированных историй Впостера, 0 — не удалять. По умолчанию история не удаляется.
delete_clock (int) Не обязательный параметр
Автоматическое удаление истории из VK (часы)
От 1 до 23
Максимум 23 часа
Данный параметр настраивается совместно с параметром delete_minutes
delete_minutes (int) Не обязательный параметр
Автоматическое удаление истории из VK (минуты)
От 1 до 59
Максимум 59 минут
Данный параметр настраивается совместно с параметром delete_clock
stories_image (string) Обязательный параметр
Ссылка на изображение для истории.
Рекомендуем загружать фото с соотношением сторон 9:16.
stories_link_url (string) Не обязательный параметр
Адрес ссылки для перехода из истории (адрес кнопки)
stories_link_text (string) Не обязательный параметр
Текст ссылки для перехода из истории.
Возможные значения:
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— Открыть профиль;questions— Задать вопрос {name};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— Слушать подкаст;
Пример
Пример кода на языке PHP для обращения к методам API.
$params = [
"id_group" => 79668981,
"name" => "Впостер",
"photo" => "https://pp.userapi.com/s/v1/if1/uKaQngH4dcpFIX6PH7v9trw8IDPU6BLczgtHkvOHccT5dElpnLkfDwuwIA4ZKN7rW9l1ohbR.jpg?quality=96&crop=0,0,1080,1080&as=32x32,48x48,72x72,108x108,160x160,240x240,360x360,480x480,540x540,640x640,720x720,1080x1080&ava=1&cs=100x100",
"date_post" => "2025-02-21 15:40",
"post_day" => "oneraz",
"stories_image" => "https://pp.userapi.com/impg/uquhuFC_proiWmRgzN-zdAsCMCQJArkZsGZUeQ/RDSLOz_qr6c.jpg?size=1556x586&quality=95&sign=72bf3351130c58f5a42018d96d2d3412&type=album",
"stories_link_url" => "https://vposter.ru",
"stories_link_text" => "attach_link",
"access_token" => "507f7e85b8d7a88c83c8df09b217882e18b5d885a1ff8c88"
];
$myCurl = curl_init();
curl_setopt_array($myCurl, [
CURLOPT_URL => "https://vposter.ru/api/v2/method/create.stories",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_POST => true,
CURLOPT_POSTFIELDS => http_build_query($params)
]);
$res= curl_exec($myCurl);
curl_close($myCurl);
$request = json_decode($res, true);
if(isset($request['response'])) {
// Успешно
} else {
if(isset($request['error']['error_msg'])) {
// Ошибка
}
}{
"response" : {
"stories_id": 5622
}
}Last updated