# Roistat REST API: Забирать заявки и звонки с источниками

Сценарий из mcp-everything. Актуально на 2026-10-24.

Прокси-лиды и звонки коллтрекинга с привязкой к визиту и рекламному источнику.

1. Заявки за период: GET /project/proxy-leads с period в формате YYYY-MM-DD-YYYY-MM-DD. В ответе name, phone, email, roistat (визит) и order_id. Время — UTC.
2. Звонки: POST /project/calltracking/call/list с filters по дате, limit и extend = ["visit", "order"], чтобы сразу получить визит и сделку. В записи есть link — ссылка на запись разговора.
3. Номера коллтрекинга и их настройки — POST /project/calltracking/phone/list.
4. Полная цепочка визитов по конкретной сделке — GET /project/orders/{orderId}/info.

```bash
curl -G "https://cloud.roistat.com/api/v1/project/proxy-leads" \
  -H "Api-key: $ROISTAT_KEY" -d project=12345 -d period=2026-10-01-2026-10-23

curl -X POST "https://cloud.roistat.com/api/v1/project/calltracking/call/list?project=12345" \
  -H "Api-key: $ROISTAT_KEY" -H 'Content-Type: application/json' \
  -d '{"filters": {"and": [["date", ">", "2026-10-01T00:00:00+0000"]]}, "limit": 100, "extend": ["visit", "order"]}'
```

## Базовые URL

- Боевой: `https://cloud.roistat.com/api/v1`

## Авторизация

Тип: API-ключ

Ключ API (один на пользователя, действует для всех его проектов) берётся в профиле: `https://cloud.roistat.com/user/profile/api`. Передаётся в заголовке `Api-key` (рекомендуется; параметр `key` в URL небезопасен). Номер проекта — в параметре `project` строки запроса; без него работают только `/user/projects` и `/account/project/create`.

```
curl 'https://cloud.roistat.com/api/v1/project/proxy-leads?project=12345&period=2021-07-07-2021-09-24' \
    --request GET \
    --header 'Content-type: application/json' \
    --header 'Api-key: {KEY}'
```

## Методы сценария

### GET /project/orders/{orderId}/info — Подробности сделки

Данные сделки, товары и полная цепочка визитов.

| Параметр | Где | Тип | Обяз. | Описание |
|---|---|---|---|---|
| `orderId` | path | string | да | ID сделки |
| `project` | query | string | да | Номер проекта |

### GET /project/proxy-leads — Прокси-лиды за период

В ответе `ProxyLeads[]`: `id`, `title`, `text`, `name`, `phone`, `email`, `roistat` (визит), `creation_date` (UTC0), `order_id`.

| Параметр | Где | Тип | Обяз. | Описание |
|---|---|---|---|---|
| `project` | query | string | да | Номер проекта |
| `period` | query | string | да | Период YYYY-MM-DD-YYYY-MM-DD |

### POST /project/calltracking/call/list — История звонков

Чтобы получить визит и сделку для каждого звонка, добавьте `visit` и `order` в `extend`. В записи звонка: `id`, `caller`, `callee`, `duration`, `status`, `date`, `link` (запись), `visit_id`, `order_id`.

| Параметр | Где | Тип | Обяз. | Описание |
|---|---|---|---|---|
| `project` | query | string | да | Номер проекта |
| `filters` | body | object | нет | Фильтры (например, по диапазону дат в and) |
| `sort` | body | array | нет | Сортировка |
| `limit` | body | integer | нет | Число записей |
| `offset` | body | integer | нет | Смещение |
| `extend` | body | array | нет | visit, order |

### POST /project/calltracking/phone/list — Номера коллтрекинга

| Параметр | Где | Тип | Обяз. | Описание |
|---|---|---|---|---|
| `project` | query | string | да | Номер проекта |
| `filters` | body | object | нет | Фильтры |
| `limit` | body | integer | нет | Число записей |
| `offset` | body | integer | нет | Смещение |

## Нюансы

- По умолчанию все методы — POST; GET допускается для методов, оканчивающихся на `/list`, и для отдельных ресурсов (проекты, прокси-лиды, детали сделки).
- Тело — JSON или XML; поддерживается CORS; время по умолчанию — UTC+0.
- По умолчанию все ответы, включая ошибки, приходят с HTTP 200; заголовок `Use-Http-Code: 1` включает реальные HTTP-коды.
- Ответы содержат `data`, `total`, `status`.
- Список сделок с `extend: visit`: при `limit` больше 1000 — 1 запрос в минуту, больше 100 — 5, меньше 100 — 10; без `extend` — 20 в минуту.

## Другие сценарии

- [Выгрузить отчёт сквозной аналитики](https://mcp-everything.ru/integrations/roistat/scenarios/vygruzit-otchet-skvoznoy-analitiki.md)
- [Передать сделки из своей CRM](https://mcp-everything.ru/integrations/roistat/scenarios/peredat-sdelki-iz-svoey-crm.md)
- [Сверить сделки с выручкой](https://mcp-everything.ru/integrations/roistat/scenarios/sverit-sdelki-s-vyruchkoy.md)

---

Если этого недостаточно — официальная документация: https://help-en.roistat.com/API/methods/about/
Вся интеграция одним документом: https://mcp-everything.ru/integrations/roistat.md