curl --request POST \
--header "XF-Api-Key: $FORUM_API_KEY" \
--header 'Accept: application/json' \
--data-urlencode 'target_node_id=456' \
'https://forum.arzguard.com/api/threads/123/move'
{
"success": true,
"thread": {
"thread_id": 123,
"sv_prefix_ids": [
1
]
}
}
Темы
Переместить тему
Перемещает тему в другой раздел с необязательным изменением заголовка и префикса.
POST
/
api
/
threads
/
{id}
/
move
curl --request POST \
--header "XF-Api-Key: $FORUM_API_KEY" \
--header 'Accept: application/json' \
--data-urlencode 'target_node_id=456' \
'https://forum.arzguard.com/api/threads/123/move'
{
"success": true,
"thread": {
"thread_id": 123,
"sv_prefix_ids": [
1
]
}
}
Перемещает тему в другой раздел с необязательным изменением заголовка и префикса.
Обязательные scopes:
Тело запроса:
Доступ
В каждом запросе обязателен заголовокXF-Api-Key. Примеры используют серверную переменную $FORUM_API_KEY; тип ключа и контекст пользователя определяют доступ к данным.
string
required
Ключ API. Храните его на сервере интеграции; в примере используется переменная окружения.
thread:write.
Особенности
Одновременно с перемещением поддерживаются простые изменения заголовка и префикса.starter_alert_reason — строковое пояснение к уведомлению автору темы.
Параметры
integer
required
ID темы. Значение
123 в примере условное.integer
required
ID целевого раздела для перемещения темы.
integer
ID префикса после перемещения. Префикс должен быть допустим в целевом разделе. Этот метод сохраняет скалярный формат параметра.
string
Заголовок темы.
boolean
При
1 уведомляет подписчиков целевого раздела, как при создании в нём новой темы.boolean
При
1 отправляет автору темы уведомление о действии.string
Текст причины в уведомлении автору темы; применяется вместе с
starter_alert.application/x-www-form-urlencoded. Данные передаются в UTF-8.
Успешный ответ
HTTP200. Пример ниже сокращён и содержит только условные данные. Полные объекты и условия видимости полей описаны в схемах данных.
| Поле | Тип | Описание |
|---|---|---|
success | true | true, если действие выполнено успешно. |
thread | Thread | Объект темы Thread. |
Ошибки
Стандартный ответ содержит массивerrors с code, message и params. Проверяйте HTTP-статус и машинный код; формат и обработка ошибок общие для API.
curl --request POST \
--header "XF-Api-Key: $FORUM_API_KEY" \
--header 'Accept: application/json' \
--data-urlencode 'target_node_id=456' \
'https://forum.arzguard.com/api/threads/123/move'
{
"success": true,
"thread": {
"thread_id": 123,
"sv_prefix_ids": [
1
]
}
}