Перейти к содержимому
ГлавнаяГайды и инструкцииcURL и HTTP-статусы: как работать с API

cURL и HTTP-статусы: как работать с API

Время чтения: 1 мин

Как собрать команду cURL для тестирования API и разобраться в HTTP-кодах: что означают 401, 403, 429 и 5xx и как исправить ошибки интеграции.

Тестирование API — это постоянные запросы с разными заголовками, телом и параметрами, и ручная сборка команды cURL в консоли отнимает время и провоцирует опечатки. Точно так же легко запутаться в кодах ответа: 401, 403, 429 и 503 выглядят похоже, а означают разные вещи.

Сборка команды cURL

cURL Command Builder собирает готовую команду из метода (GET, POST, PUT, DELETE), адреса, заголовков и тела запроса: вы выбираете нужные поля в форме, сервис формирует команду, которую остаётся вставить в терминал. Это исключает ошибки в кавычках и синтаксисе при ручном наборе.

Коды состояния

Справочник HTTP-кодов объясняет все статусы от 100 до 511: что означает каждый код, когда он появляется и как обычно исправляется. Особенно важны 4xx — ошибки клиента (например, 401 — не авторизован, 404 — ресурс не найден, 429 — превышен лимит запросов) и 5xx — ошибки сервера (500, 502, 503).

Типичный сценарий

Интеграция вернула 401 → декодируете JWT-токен, проверяете срок действия, исправляете заголовок Authorization в cURL Command Builder → команда собрана заново и выполнена в консоли. Если пришёл 429 — откройте Справочник HTTP-кодов и убедитесь, что нужно увеличить интервалы между запросами.

Частые ошибки

Важно: все файлы обрабатываются в браузере и не отправляются на сервер — безопасно для конфиденциальных изображений.