Запросы к API

Основная информация о запросах

Запрос — это обращение одного сервиса к другому для получения или отправки информации.

Запросы можно делать к любому стороннему сервису, который их поддерживает. Как правило, вы можете найти документацию к API в публичном доступе. Если этого сделать не удалось — свяжитесь с поддержкой или разработчиком нужной системы.

Isaak умеет отправлять запросы и принимать ответы в различных форматах: JSON, formdata (пары ключ/значение) или любой текстовый формат, включая xml.

Существует множество типов запросов, мы используем самые распространенные: GET, POST, PUT и DELETE.

  • GET чаще всего применяется как запрос получения информации. В некоторых случаях может использоваться равнозначно с другими типами. Например, в Telegram можно использовать и GET, и POST для одинаковых запросов.

  • POST применяется для отправки информации и создания объектов. С помощью этого метода чаще всего формируются заказы, создаются заявки и т.д.

  • PUT обновляет информацию об объекте.

  • DELETE удаляет созданный объект.

Основная информация об ответах

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

Если запрос прошел успешно, код будет иметь значение, начинающееся на 2:

  • 200 OK — успешный запрос.

  • 201 Created — в результате успешного выполнения запроса был создан новый ресурс.

  • 202 Accepted — результат был принят в обработку, но она не завершена.

Если запрос не прошел из-за ошибки параметров запроса, код ошибки будет иметь значение, начинающееся на 4:

  • 400 Bad Request — сервер обнаружил в запросе клиента синтаксическую ошибку.

  • 401 Unauthorized — для доступа к запрашиваемому ресурсу требуется аутентификация.

  • 403 Forbidden — сервер понял запрос, но он отказывается его выполнять из-за ограничений в доступе для клиента к указанному ресурсу.

  • 404 Not Found — запрашиваемый ресурс не был найден или не существует.

Если запрос не прошел из-за ошибки сервера, код ошибки будет иметь значение, начинающееся на 5:

  • 500 Internal Server Error — любая внутренняя ошибка сервера.

  • 501 Not Implemented — сервер не может обработать запрос.

  • 502 Bad Gateway — сервер, выступая в роли шлюза или прокси-сервера, получил недействительное ответное сообщение от вышестоящего сервера.

  • 503 Service Unavailable — сервер временно не имеет возможности обрабатывать запросы по техническим причинам.

  • 504 Gateaway Timeout — сервер в роли шлюза или прокси-сервера не дождался ответа от вышестоящего сервера для завершения текущего запроса.

Last updated