Текущая версия API: 1.3
Версия форума: 2.0.51
Дата выхода: 27.07.2025
Просьба писать вопросы и предложения по API в этой теме. Воспросы и предложения в других темах могут быть намотаны на писюлячку. Но и их постинг в этой теме не гарантирует, что предложения будут выполнены.
Ендпоинты:
https://nosql.ru/forum/api/get_forum_list.php
https://nosql.ru/forum/api/get_topic_list.php
https://nosql.ru/forum/api/get_post_list.php
https://nosql.ru/forum/api/get_post.php
https://nosql.ru/forum/api/get_user_data.php
https://nosql.ru/forum/api/get_topic_data.php
https://nosql.ru/forum/api/get_attachment.php
https://nosql.ru/forum/api/post_message.php
https://nosql.ru/forum/api/update_message.php
https://nosql.ru/forum/api/post_attachment.php
https://nosql.ru/forum/api/delete_posts.php
https://nosql.ru/forum/api/restore_posts.php
Валидный тоукен можно получить в профиле своего юзера. Гостевой постинг тоже возможен, но тоукен выдается только зареганным. В провиле появилась галка "Активировать API", при включении и сохранении будет сгенерен тоукен.
Базовый формат отправки такой:
1.
2.
3.
4.
{
"language": "ru",
"api_token": "4285-5291-7113-3500-5919"
}
Примеры вызовов:
https://nosql.ru/forum/api/get_forum_list.php1.
2.
3.
4.
{
"language": "ru",
"api_token": "4285-5291-7113-3500-5919"
}
1.
2.
3.
4.
5.
6.
7.
8.
9.
{
"language": "ru",
"api_token": "4285-5291-7113-3500-5919",
"forum_id": "8",
"sort": "desc",
"limit": 100, // no more than 100 allowed
"subject": "Фотографии", // if specified only the topics with this name are returned
"continue_at": "2023-01-01 00:00:00" // if omitted than before now
}
Параметр continue_at может быть использован для пошаговой подгрузки.
Параметр subject может быть использован для проверки, существует ли уже темы с таким названием.
https://nosql.ru/forum/api/get_post_list.php1.
2.
3.
4.
5.
6.
7.
8.
{
"language": "ru",
"api_token": "4285-5291-7113-3500-5919",
"topic_id": 19529,
"sort": "desc",
"limit": 100, // no more than 100 allowed
"continue_at": "2024-10-01 00:00:00" // if omitted than before now
}
Параметр continue_at может быть использован для пошаговой подгрузки.
https://nosql.ru/forum/api/get_post.php1.
2.
3.
4.
5.
{
"language": "ru",
"api_token": "1684-7912-7133-2657",
"post_id": 1000
}
1.
2.
3.
4.
5.
{
"language": "ru",
"api_token": "1753-6212-0242-0888-3460",
"topic_id": 566
}
1.
2.
3.
4.
5.
{
"language": "ru",
"api_token": "1753-6212-0242-0888-3460",
"user_id": 566
}
1.
2.
3.
4.
5.
6.
{
"language": "ru",
"api_token": "4285-5291-7113-3500-5919",
"attachment_id": 871959,
"nr": 2
}
1.
2.
3.
4.
5.
6.
7.
{
"language": "ru",
"api_token": "1753-6212-0242-0888-3460",
"posts": [
872084, 872085
]
}
1.
2.
3.
4.
5.
6.
7.
{
"language": "ru",
"api_token": "1753-6212-0242-0888-3460",
"posts": [
872084, 872085
]
}
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
{
"language": "ru",
"api_token": "4285-5291-7113-3500-5919",
"forum_id": 8,
"topic_id": 19546, // omit to create a new topic
"is_thematic": 0,
"is_adult": 0,
"blog": 0,
"no_guests": 0,
"request_moderation": 0,
"post_as_guest": "Карапуз", // omit to post under the user name
"citated_posts": "",
"subject": "Привет медвед", // not necessary if posting to an existing topic
"message": "777"
}
В ответ приходит вся инфа о сделанном посте.
https://nosql.ru/forum/api/post_message.php - с аттачами
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.
22.
{
"language": "ru",
"api_token": "4285-5291-7113-3500-5919",
"forum_id": 8,
"topic_id": 19546, // omit to create a new topic
"is_thematic": 0,
"is_adult": 0,
"blog": 0,
"no_guests": 0,
"request_moderation": 0,
"post_as_guest": "Карапуз", // omit to post under the user name
"citated_posts": "",
"subject": "Привет медвед", // not necessary if posting to an existing topic
"message": "777",
"attachments": [
{
"file_name": "photo_2024-09-01_18-14-34.jpg",
"mime_type": "image/jpg",
"base64_contents": "......"
}
]
}
- постфактумная отправка аттачмента
Аттачмент отправляется в бинарном формате, параметры в таком случае нужно передать GET запросом через переменные
https://nosql.ru/forum/api/post_attachment.php?api_token=1753-6212-0242-0888-3460&file_name=test.jpg&mime_type=image/jpeg&post_id=872072
Параметры:
api_token
file_name
mime_type
post_id
https://nosql.ru/forum/api/update_message.php1.
2.
3.
4.
5.
6.
7.
{
"language": "ru",
"api_token": "4285-5291-7113-3500-5919",
"post_id": 8,
"subject": "Привет медвед", // not necessary if changing of the subject is not necessary
"message": "Новое сообщение"
}
В ответ приходит вся инфа о сделанном посте.
Ендпоинт поддерживает и замену и удаление аттачей. Чтобы удалить, нужно запостить апдейт без аттачей. И следовательно, если меняешь пост с аттачами, их нужно также указать при апдейте и препостить.
Ендпоинт поддерживает и замену названия топика. Но это работает только при апдейте первого поста темы.
)
