РУКОВОДСТВО · ОБНОВЛЕНО 2026-11-15
HTTP 405 в AI API — как проверить метод запроса
Проверьте HTTP-метод, конечный URL и заголовок Allow. Частая причина при отладке — открытие POST-маршрута в браузере, который отправляет GET.
Проверьте HTTP-метод, конечный URL и заголовок Allow. Частая причина при отладке — открытие POST-маршрута в браузере, который отправляет GET.
1. Сверьте операцию
Запишите метод и путь из документации. Если операция создаёт ответ через POST, проверяйте именно отправленный POST с безопасным тестовым телом. Отдельно проверьте префикс версии и путь операции.
2. Прочитайте Allow
Ответ 405 должен включать Allow со списком методов ресурса. Сравните его с операцией. Если ожидали POST, а Allow содержит только GET и HEAD, проверьте, не обращается ли клиент к странице документации или маршруту списка.
3. Посмотрите цепочку перенаправлений
В журнале клиента сохраните статусы и методы каждого перехода. Для 303 следующий запрос обычно становится GET. 307 и 308 сохраняют метод. Исправьте конечный адрес в клиенте и повторите проверку на тестовом стенде.
4. Найдите источник ответа
Сопоставьте запрос в журнале приложения и прокси. Если приложение не видит запрос, проверьте правила маршрутизации. При запросе из браузера отдельно посмотрите, возник ли 405 на OPTIONS перед фактическим POST.
Частые вопросы
Почему в браузере 405?
Адресная строка посылает GET. Для операции POST используйте клиент API.
Поможет ли другой API-ключ?
Сначала исправьте метод и URL. Проверка ключа относится к авторизации.
Что означает Allow?
Методы, доступные для конкретного ресурса.
Зачем смотреть OPTIONS?
Браузер может отправить предварительный запрос при обращении к другому источнику.