Сервисные роуты
Сервисные роуты проверяют обработку запросов и разные типы контроллеров. Все операции диагностические: данные пользователей, групп и других сущностей не изменяются.
Включите их в настройках роутов. Адреса ниже указаны относительно пути интерфейса API.
GET up
Базовая проверка доступности API и вызова метода контроллера. Можно передать произвольные параметры в строке запроса.
| Параметр | Значение |
|---|---|
| Контроллер | Класс UpIndex, метод list() |
| Обязательные параметры | Нет |
| Успешный ответ | HTTP 200, JSON |
Переданные значения возвращаются в поле parameters.
Пример запроса
GET up/user/{id}
Проверяет передачу параметра в адресе роута. Значение {id} попадает в parameters.id вместе с остальными параметрами запроса.
| Параметр | Значение |
|---|---|
| Контроллер | Класс UpIndex, метод list() |
| Параметр адреса | id; отдельная проверка типа в карте не задана |
| Успешный ответ | HTTP 200, JSON |
Пример запроса с ID и строкой запроса
GET up/group/{id}
Показывает настройку доступа по системной группе администраторов.
| Параметр | Значение |
|---|---|
| Контроллер | Класс UpIndex, метод list() |
| Параметр адреса | id |
| Группа в whitelist | AccessConfig::GROUP_CODE_ADMINISTRATOR |
| Ответ при текущей настройке | HTTP 403, GROUP_WHITELIST |
Роут виден администраторам в документации. В его карте не задана авторизация API, поэтому запрос проверяется как анонимный и не проходит whitelist.
POST up
Проверяет передачу тела запроса и вызов метода create(). Принятые параметры возвращаются в parameters.
| Параметр | Значение |
|---|---|
| Контроллер | Класс UpIndex, метод create() |
| Обязательные параметры | Нет |
| Успешный ответ | HTTP 201, JSON |
PUT up
Проверяет выполнение PHP-файла как контроллера и формирование XML-ответа.
| Параметр | Значение |
|---|---|
| Контроллер | PHP-файл UpScript.php |
| Обязательные параметры | Нет |
| Успешный ответ | HTTP 200, XML |
| Технические ключи | Отключены в карте |
| Корневой элемент | response, задан самим контроллером |
Пример запроса и получения XML
DELETE up
Проверяет выполнение вызываемого класса через __invoke().
| Параметр | Значение |
|---|---|
| Контроллер | Класс UpInvoke, метод __invoke() |
| Обязательные параметры | Нет |
| Успешный ответ | HTTP 200, JSON |
Контроллер явно задаёт статус 200, поэтому диагностические данные передаются в теле ответа.
Пример запроса
Данные ответа
Успешный вызов возвращает:
| Поле | Значение |
|---|---|
| method | HTTP-метод запроса |
| controller | Класс или путь PHP-контроллера |
| action | Действие контроллера |
| description | Описание роута из карты |
| parameters | Полученные параметры запроса |
Расположение данных зависит от технической обёртки. В PUT данные находятся внутри корневого элемента response.
Формат ответа можно изменить параметром format=json или format=xml в строке запроса.