Запуск
Выполните после установки, в административном разделе сайта.
1. Задайте адреса
- Откройте «Сервисы → API-платформа → Настройки модуля».
- На вкладке «Основные», в блоке «Настройка путей», заполните поля:
| Поле | Значение |
|---|---|
| Путь интерфейса | api |
| Путь документации | api/docs |
| Путь карты роутов | Оставьте пустым |
- Нажмите «Сохранить».
Пути указываются без домена. Модуль сам создаст точки входа и включит API.
2. Включите проверочные запросы
- Перейдите на вкладку «Роуты».
- Отметьте «Активировать сервисные роуты».
- Нажмите «Сохранить».
3. Откройте документацию API
- Выберите «Сервисы → API-платформа → Документация».
- Проверьте адрес страницы: при указанных выше настройках это
/api/docs/на вашем сайте. - В поле
Serversпроверьте адрес API: он должен указывать на ваш сайт и путь/api/.
В списке операций должен быть GET /up. Это встроенный запрос проверки API.
4. Выполните первый запрос
- Раскройте
GET /up. - Нажмите
Try it out, затемExecute. КнопкаAuthorizeдля этого запроса не нужна. - В блоке
Server responseнайдите фактический код и тело ответа.
Результат: код 200, в Response body — JSON с result.method = GET и result.action = list.
Пример полного ответа:
{
"request_id": "0af1b6c2d3e4f5a6b7c8d9e0f1a2b3c4",
"status": {
"code": 200,
"title": "200 OK",
"message": "success"
},
"result": {
"method": "GET",
"controller": "Native\\Api\\Controller\\Up\\UpIndex",
"action": "list",
"description": "Проверка доступности и работоспособности API-сервиса",
"parameters": []
},
"time": {
"start": 1790586000.125,
"finish": 1790586000.1875,
"duration": 0.0625,
"date_start": "28.09.2026 12:00:00",
"date_finish": "28.09.2026 12:00:00",
"timestamp": {
"date_start": 1790586000,
"date_finish": 1790586000
}
}
}5. Продолжите проверку
Оставьте сервисные роуты включёнными и перейдите к проверке работы. Там проверяются параметры, авторизация, токены и история запросов.
Если результат отличается
| Что произошло | Что проверить |
|---|---|
| Нет пункта «Документация» | Сохранён ли «Путь документации». Открыта ли админка под администратором |
| В документации нет GET /up | Включены ли сервисные роуты. Сохраните настройки и обновите страницу документации |
| Вместо JSON — страница сайта или HTML-ошибка 404 | Адрес в Servers и сохранённый «Путь интерфейса». Если они верны — настройки обработки URL на сервере |
| JSON с кодом ROUTE_NOT_FOUND | Выбран ли GET /up, включены ли сервисные роуты, нет ли ошибки в адресе |
| HTTP 403 | Код ошибки в ответе и ограничения доступа. Вход в админку не отменяет ограничения API |
| HTTP 500 или Failed to fetch | Для 500 проверьте журнал ошибок PHP; для Failed to fetch — доступность адреса из Servers и HTTPS-сертификат. Если документация и API на разных доменах — CORS |
Если ошибка остаётся, сохраните адрес запроса, HTTP-код и ответ без паролей и токенов. Передайте их в поддержку.