---
metadata:
  - name: generator
    content: Diplodoc Platform v5.70.0
alternate:
  - https://yandex.ru/dev/tickets/agent/doc/ru/concepts/query-format.md
  - href: https://yandex.ru/dev/tickets/agent/doc/ru/concepts/query-format.md
    type: text/markdown
    title: Markdown version
  - href: https://yandex.ru/dev/tickets/agent/doc/ru/llms.txt?revision=r22096604
    rel: describedby
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/dev/tickets/agent/doc/ru/llms.txt?revision=r22096604

# Формат запросов к API

Взаимодействие с API осуществляется по протоколу HTTPS посредством POST-запросов.

Сервис возвращает данные в формате JSON.

## Структура запросов

В каждом запросе передаются обязательные query-параметры:

* `action` — идентификатор запроса.
* `auth` — идентификатор внешней системы. Как формируется идентификатор, см. в разделе [Доступ к API](https://yandex.ru/dev/tickets/agent/doc/ru/concepts/access.md).
* `city_id` — идентификатор города (кроме запроса `city.list`).

## Структура ответов

**Успешный запрос**

```json
{
  "status": "0",
  "result": <результат>
}
```

**Ошибка**

```json
{
  "status": "1",
  "error": <описание ошибки>
}
```
