# rest_authentication_errors

URL: https://chugunov.pro/api-wordpress/filters/rest_authentication_errors/
Проверено на WordPress 6.9, обновлено 06.08.2026.
Источник: независимый русскоязычный справочник chugunov.pro. Не является официальной документацией WordPress.

Тип: хук-фильтр.
Появился в версии: 4.4.0.

## Сигнатура

```php
apply_filters( 'rest_authentication_errors', WP_Error|null|true $errors )
```

## Описание

Используется для передачи WP_Error от метода аутентификации обратно в API.
Методы аутентификации должны сначала проверять, используются ли они, так как на сайте может быть включено несколько методов аутентификации (cookies, HTTP basic auth, OAuth). Если подключённый метод аутентификации фактически не применяется, следует вернуть null, чтобы указать, что проверку должен выполнить другой метод аутентификации. Аналогично, функции обратного вызова должны убедиться, что значение равно null, прежде чем проверять наличие ошибок.
При возникновении ошибки может быть возвращён экземпляр WP_Error, и он должен соответствовать формату, используемому методами API внутренне (то есть должны использоваться данные о статусе). Функция обратного вызова может вернуть true, чтобы указать, что метод аутентификации был использован и завершился успешно.

## Параметры

- `$errors` `WP_Error|null|true` — обязательный. WP_Error, если произошла ошибка аутентификации, null, если метод аутентификации не использовался, true, если аутентификация прошла успешно.

## Фильтруемое значение

WP_Error, если произошла ошибка аутентификации, null, если метод аутентификации не использовался, true, если аутентификация прошла успешно.

## Исходный код

Файл: `wp-includes/rest-api/class-wp-rest-server.php:197`

```php
return apply_filters( 'rest_authentication_errors', null );
```

## История изменений

- 4.4.0 — Introduced.

## Связанные

Используется в: `WP_REST_Server::check_authentication`.

Оригинал в официальной документации: https://developer.wordpress.org/reference/hooks/rest_authentication_errors/
