curl --request POST 'https://forum.arzguard.com/api/me/email' \
--header "XF-Api-Key: $FORUM_API_KEY" \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'current_password=EXAMPLE_CURRENT_PASSWORD' \
--data-urlencode 'email=user@example.invalid'
{
"success": true,
"confirmation_required": true
}
Текущий пользователь
Изменить свой email
Меняет email текущего пользователя после проверки его действующего пароля.
POST
/
api
/
me
/
email
curl --request POST 'https://forum.arzguard.com/api/me/email' \
--header "XF-Api-Key: $FORUM_API_KEY" \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'current_password=EXAMPLE_CURRENT_PASSWORD' \
--data-urlencode 'email=user@example.invalid'
{
"success": true,
"confirmation_required": true
}
Меняет email текущего пользователя после проверки его действующего пароля.
Текущий пароль проверяется даже при Super key и обходе обычных прав. У аккаунта должен быть обработчик парольной аутентификации. Результат
Тело запроса:
Ошибки возвращаются в общей структуре
Примеры сокращены и содержат только условные значения. Состав полей объектов зависит от прав, контекста и установленных дополнений.
confirmation_required=true означает, что завершение изменения требует подтверждения адреса.
Доступ
ПередавайтеXF-Api-Key в заголовке каждого запроса. Типы ключей и выбор пользователя.
Требуемые scopes: user:write. Все перечисленные разрешения нужны одновременно.
Нужен контекст зарегистрированного пользователя. Для Super key укажите XF-Api-User; доступ к объектам и действиям проверяется отдельно от scopes.
Параметры
string
required
Секретный API-ключ. В примерах ключ берётся из серверной переменной
$FORUM_API_KEY.application/x-www-form-urlencoded. Вложенные значения передавайте в форме с квадратными скобками в имени поля.
string
required
Действующий пароль текущего пользователя. Проверяется и при использовании Super key.
string
required
Новый email пользователя. В примерах используется зарезервированный домен
example.invalid.Ответ
HTTP200, JSON. Схемы объектов и условные поля.
true
Результат выполнения операции.
boolean
Нужно ли подтверждение нового email после изменения.
errors. Обрабатывайте поле code; текст message может меняться или переводиться. Формат ошибок.
curl --request POST 'https://forum.arzguard.com/api/me/email' \
--header "XF-Api-Key: $FORUM_API_KEY" \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'current_password=EXAMPLE_CURRENT_PASSWORD' \
--data-urlencode 'email=user@example.invalid'
{
"success": true,
"confirmation_required": true
}