Ошибки клиент-сервер во время вызова API

При вызове API в FlutterFlow вы можете столкнуться с ошибками клиент-сервер. Обычно они проявляются в виде кодов состояния, которые указывают на то, что именно пошло не так — либо на вашей стороне (клиент), либо на сервере, с которого вы запрашиваете данные.

Это руководство поможет вам разобраться в наиболее распространённых кодах ошибок API и в том, как их исправить.

Подробнее об API вы можете узнать из нашего руководства по документации API.

Распространённые коды состояния на стороне клиента

Эти ошибки обычно возникают из-за некорректных запросов со стороны клиента.

• 400 – Bad Request

  Ошибка 400 — это общий ответ, указывающий на то, что сервер не смог понять запрос из-за неправильного синтаксиса. Распространённые причины включают неверные параметры запроса или отсутствие полей в теле запроса. Убедитесь, что запрос правильно отформатирован и содержит всю необходимую информацию.

  подсказка

  Проверьте документацию самого API, чтобы убедиться, что вы включаете правильные поля и заголовки.

  

• 401 – Unauthorized

  Этот код состояния появляется, когда аутентификация ещё не предоставлена. Чтобы устранить проблему, убедитесь, что вы зарегистрировались для работы с API и включили свой API-ключ в HTTP-заголовок запроса.

  

• 403 – Forbidden

  Получение ошибки 403 означает, что вы прошли аутентификацию, но не имеете прав доступа к запрашиваемому ресурсу. Это может быть вызвано использованием неверного API-ключа или попыткой доступа к функциям, недоступным в вашем плане подписки.

  

• 404 – Not Found

  Ошибка 404 указывает на то, что запрашиваемый URL не существует на сервере. Это может быть вызвано опечаткой в URL или изменениями в конечных точках API. Всегда проверяйте URL и следите за обновлениями API.

  подсказка

  Всегда дважды проверяйте URL запроса перед дальнейшей диагностикой.

  

• 407 – Proxy Authentication Required

  Вы не прошли аутентификацию на прокси-сервере. Это встречается реже, но может произойти в ограниченных сетевых средах.

• 422 – Unprocessable Entity

  Ваш запрос был корректно сформирован, но его не удалось обработать. Например, передача latlng без запятой.

• 429 – Too Many Requests

  Эта ошибка возникает, когда за короткий период отправляется слишком много запросов, превышая лимиты скорости API. Чтобы избежать этого, внедрите механизм ограничения запросов или проверьте план подписки API, чтобы убедиться, что он соответствует вашим потребностям.

  подсказка

  Проверьте лимиты вашего плана API и рассмотрите возможность ограничения запросов из приложения.

Распространённые коды состояния на стороне сервера

Эти ошибки возникают на стороне сервера API.

• 500 – Internal Server Error

  Ошибка 500 может возникать по разным причинам и часто указывает на сбой сервера API. Проверьте точность вашего запроса и обратитесь к документации API для информации о известных проблемах.

• 501 – Not Implemented

  Эта ошибка возникает, когда используемый в запросе HTTP-метод не поддерживается сервером. Попробуйте другой HTTP-метод или проверьте документацию API на предмет поддерживаемых методов, чтобы решить проблему.

• 502 – Bad Gateway

  Эта ошибка означает, что сервер, выступающий в роли шлюза или прокси, получил некорректный ответ от upstream-сервера. Обычно это временная проблема, которую должен решить провайдер API.

• 503 – Service Unavailable

  Код состояния 503 указывает на то, что сервер временно не может обработать запрос из-за перегрузки или обслуживания. Часто лучшее решение — подождать перед отправкой следующего запроса.

• 504 – Gateway Timeout

  Ошибка 504 предполагает, что сервер, выступающий в роли шлюза, не получил своевременный ответ от upstream-сервера. Это может быть вызвано задержками в сети или слишком медленной обработкой запроса на сервере API.

Шаги по устранению неисправностей

• Clear Browser Cache and Cookies

  Если вы сталкиваетесь с ошибкой 400 Bad Request, очистка кэша и куки браузера может решить проблемы, связанные с истёкшими или недействительными данными.

• Verify the Requested URL

  Убедитесь, что URL или конечная точка правильные. Помните, что доменные имена чувствительны к регистру.

• Adjust Request Parameters

  Для ошибок 400 проверьте, не слишком ли большой размер файла (для POST-запросов) или нет ли других неверных параметров.

• Consult API Documentation

  Всегда обращайтесь к официальной документации API для получения конкретных требований и советов по устранению неисправностей.

• Contact API Support

  Если проблемы продолжаются, обратитесь в службу поддержки API — это может предоставить дополнительную помощь и понимание того, как решить проблему.

Понимание этих распространённых кодов состояний ошибок API и способов их устранения может значительно упростить процесс разработки, обеспечивая более эффективное и надёжное взаимодействие между вашим приложением и используемыми API.

Заключительные советы

• Всегда проверяйте документацию самого API, анализируйте запрос и ищите сообщения об ошибках. Если проблема не исчезает, обратитесь к провайдеру API.
• После устранения проблемы ваши вызовы должны возвращать 200 OK, что означает, что всё работает как ожидалось!