API › Блог-записи

Блог-записи post

9 actions · URL: /api.php?act=<name> или /api/v1/post/<action>

post_get GET /api.php?act=post_get auth read

Получить блог-запись по id.

Параметры

имятипreqописание
id int да
rate-limit: 120 / 1 мин на user
post_comments_list GET /api.php?act=post_comments_list auth read

Список комментариев к посту.

Параметры

имятипreqописание
id int да
start int нет
limit int нет
rate-limit: 120 / 1 мин на user
post_create POST /api.php?act=post_create auth write csrf

Создать блог-запись. Поддерживает текст, голос (post_type=1) и кружок (post_type=2).

Параметры

имятипreqописание
title string для text
body string для text HTML/BBCode
post_type int нет 0 = text (default), 1 = voice, 2 = circle
voice_id int для post_type=1
circle_id int для post_type=2
privacy int нет bitmask: 63=all, 3=friends, 1=self
comments int нет кто может комментировать (bitmask)
search int нет 1 — показывать в поиске
main int нет 1 — отправить на главную
main_show int нет 1 — видимость в ленте (default 1)
cat_id int нет категория блога
images string нет JSON array / CSV of image URLs → HTML <img>
userphoto int нет прикрепить фото из альбома

Ответ result

blogentry_id
int
nsfw
bool
rate-limit: 10 / 1 ч на user
post_edit POST /api.php?act=post_edit auth write csrf

Редактировать свою блог-запись.

Параметры

имятипreqописание
id int да
title string да
body string да HTML/BBCode
privacy int нет bitmask
comments int нет кто может комментировать
search int нет 1 — в поиске
cat_id int нет
main int нет
main_show int нет видимость в ленте
images string нет JSON array of image URLs → HTML <img>

Ответ result

blogentry_id
int
updated
bool
rate-limit: 30 / 1 мин на user
post_delete POST /api.php?act=post_delete auth write csrf

Удалить свою запись.

Параметры

имятипreqописание
id int да
rate-limit: 30 / 1 мин на user
post_set_fixed POST /api.php?act=post_set_fixed auth write csrf

Закрепить (fixed=1) или открепить (fixed=0) запись в блоге. Не больше одной закреплённой на пользователя.

Параметры

имятипreqописание
id int да blogentry_id
fixed int да 0|1

Ответ result

blogentry_id
int
fixed
bool
rate-limit: 30 / 1 мин на user
post_comment_add POST /api.php?act=post_comment_add auth write csrf

Добавить комментарий.

Параметры

имятипreqописание
id int да
body string да
rate-limit: 30 / 1 мин на user
post_comment_delete POST /api.php?act=post_comment_delete auth write csrf

Удалить свой комментарий.

Параметры

имятипreqописание
comment_id int да
rate-limit: 30 / 1 мин на user
post_comment_edit POST /api.php?act=post_comment_edit auth write csrf

Редактировать свой комментарий к посту.

Параметры

имятипreqописание
id int да blogentry_id
comment_id int да
body string да HTML
rate-limit: 30 / 1 мин на user