> For the complete documentation index, see [llms.txt](https://alt3rmann.gitbook.io/isaak-io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://alt3rmann.gitbook.io/isaak-io/zaprosy-i-integracii/zaprosy-k-api.md).

# Запросы к API

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

{% hint style="info" %}
Запрос — это обращение одного сервиса к другому для получения или отправки информации.
{% endhint %}

Запросы можно делать к любому стороннему сервису, который их поддерживает. Как правило, вы можете найти документацию к 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 — сервер в роли шлюза или прокси-сервера не дождался ответа от вышестоящего сервера для завершения текущего запроса.