API v1
API для разработчиков
Выгружайте оценки, комментарии и итоги по дням в CRM, BI или таблицу. API только читает данные: изменить через него ничего нельзя.
Адрес API: https://trust-eer.ru/api/v1 · ответы в JSON · доступно на тарифе «Бизнес»
Быстрый старт
- Откройте в кабинете Настройки → API. Раздел доступен владельцу компании на тарифе «Бизнес».
- Введите название, например «amoCRM» или «Power BI», и нажмите «Создать токен».
- Скопируйте токен: он начинается с
trs_и показывается один раз. Если потеряли — удалите и создайте новый. - Передавайте токен в заголовке каждого запроса:
curl "https://trust-eer.ru/api/v1/locations" \
-H "Authorization: Bearer trs_ваш_токен"Токен даёт доступ ко всем оценкам и контактам посетителей компании. Храните его на сервере или в настройках интеграции, не вставляйте в код сайта и не пересылайте в чатах. Если токен попал к посторонним, удалите его в настройках: запросы с ним сразу перестанут работать.
Авторизация
Каждый запрос передаёт токен в заголовке Authorization: Bearer trs_…. Токенов может быть несколько, например, отдельный для каждой интеграции: так проще отключить одну, не трогая другие. В настройках видно, когда токен использовался последний раз.
Для совместимости со старой версией работает и параметр ?api_token=, но лучше им не пользоваться: адрес с токеном остаётся в логах и истории браузера.
Методы
Все методы — GET, параметры передаются в адресе. Если нужны оценки одной точки, сначала узнайте её id через /locations.
ТочкиGET /api/v1/locations
Все точки компании с id для фильтра location, ссылкой на опрос и числом оценок. Точка на паузе не принимает новые оценки: по тарифу превышен лимит точек.
Параметров нет.
Пример запроса
curl "https://trust-eer.ru/api/v1/locations" \
-H "Authorization: Bearer $TRUSTEER_TOKEN"Пример ответа
{
"ok": true,
"workspace": {
"id": "cm3x0w1k20000ab12cd34ef56",
"name": "Кофейня Зерно"
},
"items": [
{
"id": "k7f2m9",
"name": "Кофейня на Лесной",
"unit": "Лесная, 5",
"survey_url": "https://trust-eer.ru/r/k7f2m9",
"paused": false,
"responses_total": 128,
"created_at": "2026-09-02T08:15:00.000Z"
},
{
"id": "p3x8q1",
"name": "Кофейня у метро",
"unit": null,
"survey_url": "https://trust-eer.ru/r/p3x8q1",
"paused": false,
"responses_total": 13,
"created_at": "2026-10-10T11:40:00.000Z"
}
]
}Поля ответа
okboolean | true, если запрос выполнен. |
workspaceobject | Компания, к которой относится токен. |
workspace.idstring | id компании. |
workspace.namestring | Название компании. |
itemsarray | Точки, сначала созданные раньше. |
items[].idstring | id точки — для параметра location. |
items[].namestring | Название точки. |
items[].unitstring или null | Подразделение или адрес. |
items[].survey_urlstring | Ссылка на опрос, она же в QR-коде. |
items[].pausedboolean | true — точка на паузе по тарифу. |
items[].responses_totalinteger | Оценок за всё время. |
items[].created_atstring | Когда создана, ISO 8601 UTC. |
ОценкиGET /api/v1/responses
Оценки посетителей с комментариями и контактами, постранично. Подходит для выгрузки в CRM, BI или таблицу. Новые записи — первыми, если не указан order=asc.
Параметры
| Параметр | Описание |
|---|---|
locationstring | id точки из метода /locations. Без параметра — все точки компании. |
date_fromГГГГ-ММ-ДД | С этого дня включительно, ГГГГ-ММ-ДД, по московскому времени. |
date_toГГГГ-ММ-ДД | По этот день включительно, ГГГГ-ММ-ДД, по московскому времени. |
ratingstring | Оценки через запятую, от 1 до 5. Например, 1,2,3 — только негатив. |
scenariolow | high | low — оценки 1–3 (комментарий владельцу), high — 4–5 (кнопки отзывов на картах). |
handledboolean | true — только обработанные жалобы, false — только необработанные. |
limitinteger | Сколько записей вернуть, от 1 до 2000. По умолчанию 200. |
offsetinteger | Сколько записей пропустить. Для следующей страницы берите pagination.next_offset. По умолчанию 0. |
orderdesc | asc | desc — новые первыми, asc — старые первыми. По умолчанию desc. |
Пример запроса
curl "https://trust-eer.ru/api/v1/responses?date_from=2026-11-01&limit=100" \
-H "Authorization: Bearer $TRUSTEER_TOKEN"Пример ответа
{
"ok": true,
"workspace": {
"id": "cm3x0w1k20000ab12cd34ef56",
"name": "Кофейня Зерно"
},
"filters": {
"date_from": "2026-11-01",
"date_to": null,
"location": null,
"rating": null,
"scenario": null,
"handled": null,
"limit": 100,
"offset": 0,
"order": "desc"
},
"stats": {
"total": 2,
"unique": 2,
"non_unique": 0
},
"pagination": {
"limit": 100,
"offset": 0,
"next_offset": null
},
"items": [
{
"id": "cm3y8a1b20003xy45zt67uv89",
"location": {
"id": "k7f2m9",
"name": "Кофейня на Лесной",
"unit": "Лесная, 5"
},
"rating": 2,
"scenario": "low",
"comment": "Долго ждали заказ",
"contact": "+7 900 000-00-00",
"action_id": null,
"action_title": null,
"handled_at": "2026-11-12T10:05:00.000Z",
"handled_by": "Анна",
"handled_by_email": "anna@example.com",
"handled_note": "Позвонили, извинились, подарили кофе",
"created_at": "2026-11-12T09:31:00.000Z"
},
{
"id": "cm3y7z9k10002xy45zt67uv88",
"location": {
"id": "k7f2m9",
"name": "Кофейня на Лесной",
"unit": "Лесная, 5"
},
"rating": 5,
"scenario": "high",
"comment": null,
"contact": null,
"action_id": "cm3a1b2c30001ab12cd34ef56",
"action_title": "Яндекс Карты",
"handled_at": null,
"handled_by": null,
"handled_by_email": null,
"handled_note": null,
"created_at": "2026-11-11T16:02:00.000Z"
}
]
}Поля ответа
okboolean | true, если запрос выполнен. |
workspaceobject | Компания, к которой относится токен. |
workspace.idstring | id компании. |
workspace.namestring | Название компании. |
filtersobject | Применённые фильтры, как их понял сервер. |
filters.date_fromstring или null | С какого дня. |
filters.date_tostring или null | По какой день. |
filters.locationstring или null | id точки. |
filters.ratingarray или null | Оценки. |
filters.scenariostring или null | low или high. |
filters.handledboolean или null | Обработана ли жалоба. |
filters.limitinteger | Размер страницы. |
filters.offsetinteger | Сдвиг. |
filters.orderstring | Порядок сортировки. |
statsobject | Итоги по всем записям под фильтром, не только по странице. |
stats.totalinteger | Всего оценок. |
stats.uniqueinteger | Уникальных посетителей. |
stats.non_uniqueinteger | Повторных оценок от тех же посетителей. |
paginationobject | Постраничная выгрузка. |
pagination.limitinteger | Размер страницы. |
pagination.offsetinteger | Сдвиг текущей страницы. |
pagination.next_offsetinteger или null | offset следующей страницы; null — это последняя страница. |
itemsarray | Оценки. |
items[].idstring | id оценки. |
items[].locationobject | Точка. |
items[].location.idstring | id точки. |
items[].location.namestring | Название точки. |
items[].location.unitstring или null | Подразделение. |
items[].ratinginteger | Оценка от 1 до 5. |
items[].scenariostring | low (1–3) или high (4–5). |
items[].commentstring или null | Комментарий посетителя. |
items[].contactstring или null | Контакт для ответа, если оставил. |
items[].action_idstring или null | id нажатой кнопки отзыва. |
items[].action_titlestring или null | Кнопка, которую нажал посетитель. |
items[].handled_atstring или null | Когда жалоба отмечена обработанной. |
items[].handled_bystring или null | Кто обработал. |
items[].handled_by_emailstring или null | Email того, кто обработал. |
items[].handled_notestring или null | Чем закончилось. |
items[].created_atstring | Когда поставлена оценка, ISO 8601 UTC. |
ИтогиGET /api/v1/summary
Сколько оценок, сколько уникальных посетителей и средняя оценка — всего и по дням (по московскому времени). Удобно для графиков в BI.
Параметры
| Параметр | Описание |
|---|---|
locationstring | id точки из метода /locations. Без параметра — все точки компании. |
date_fromГГГГ-ММ-ДД | С этого дня включительно, ГГГГ-ММ-ДД, по московскому времени. |
date_toГГГГ-ММ-ДД | По этот день включительно, ГГГГ-ММ-ДД, по московскому времени. |
ratingstring | Оценки через запятую, от 1 до 5. Например, 1,2,3 — только негатив. |
scenariolow | high | low — оценки 1–3 (комментарий владельцу), high — 4–5 (кнопки отзывов на картах). |
handledboolean | true — только обработанные жалобы, false — только необработанные. |
Пример запроса
curl "https://trust-eer.ru/api/v1/summary?date_from=2026-11-01&date_to=2026-11-30" \
-H "Authorization: Bearer $TRUSTEER_TOKEN"Пример ответа
{
"ok": true,
"workspace": {
"id": "cm3x0w1k20000ab12cd34ef56",
"name": "Кофейня Зерно"
},
"filters": {
"date_from": "2026-11-01",
"date_to": "2026-11-30",
"location": null,
"rating": null,
"scenario": null,
"handled": null
},
"totals": {
"total": 41,
"unique": 37,
"avg_rating": 4.46
},
"daily": [
{
"date": "2026-11-01",
"cnt": 6,
"uniq_cnt": 6,
"avg_rating": 4.5
},
{
"date": "2026-11-02",
"cnt": 9,
"uniq_cnt": 8,
"avg_rating": 4.33
}
]
}Поля ответа
okboolean | true, если запрос выполнен. |
workspaceobject | Компания, к которой относится токен. |
workspace.idstring | id компании. |
workspace.namestring | Название компании. |
filtersobject | Применённые фильтры, как их понял сервер. |
filters.date_fromstring или null | С какого дня. |
filters.date_tostring или null | По какой день. |
filters.locationstring или null | id точки. |
filters.ratingarray или null | Оценки. |
filters.scenariostring или null | low или high. |
filters.handledboolean или null | Обработана ли жалоба. |
totalsobject | Итоги за период. |
totals.totalinteger | Всего оценок. |
totals.uniqueinteger | Уникальных посетителей. |
totals.avg_ratingnumber или null | Средняя оценка; null, если оценок нет. |
dailyarray | По дням, только дни с оценками. |
daily[].datestring | День, ГГГГ-ММ-ДД. |
daily[].cntinteger | Оценок за день. |
daily[].uniq_cntinteger | Уникальных посетителей за день. |
daily[].avg_ratingnumber | Средняя оценка за день. |
Постраничная выгрузка и время
/responses отдаёт до 2000 записей за запрос (по умолчанию 200). Чтобы выгрузить всё, повторяйте запрос с offset из pagination.next_offset, пока он не станет null. Для регулярной выгрузки удобно брать order=asc и date_from — день последней синхронизации.
let offset = 0;
const all = [];
while (offset !== null) {
const res = await fetch(`https://trust-eer.ru/api/v1/responses?order=asc&limit=2000&offset=${offset}`, {
headers: { Authorization: `Bearer ${process.env.TRUSTEER_TOKEN}` },
});
const data = await res.json();
if (!data.ok) throw new Error(data.error);
all.push(...data.items);
offset = data.pagination.next_offset;
}date_fromиdate_to— дни по московскому времени, обе границы включительно.created_atиhandled_at— в формате ISO 8601 по UTC, например2026-11-12T09:31:00.000Z— это 12:31 по Москве.- Дни в
/summaryсчитаются по Москве.
Ошибки
При ошибке ответ — { "ok": false, "error": "…" } и код HTTP:
| Код | Пример error | Что случилось |
|---|---|---|
| 400 | rating: укажите числа от 1 до 5 через запятую | Неверный параметр запроса. В тексте ошибки — какой и что ожидается. |
| 401 | missing api_token | Токен не передан: нет заголовка Authorization. |
| 402 | API доступен на тарифе «Бизнес» | Тариф компании не включает API, например, закончилась оплата. |
| 403 | invalid token | Такого токена нет: опечатка, или токен удалён в настройках. |
Попробовать запрос
Вставьте токен, выберите метод и параметры — ответ появится ниже.
Тот же запрос в терминале
curl "https://trust-eer.ru/api/v1/locations" \
-H "Authorization: Bearer $TRUSTEER_TOKEN"OpenAPI и Postman
Описание API в формате OpenAPI 3.1 — по адресу https://trust-eer.ru/api/v1/openapi.json. Его понимают Postman, Insomnia, Swagger и генераторы клиентов.
- Postman: Import → Link → вставьте адрес выше. Токен укажите в Authorization → Bearer Token.
- Insomnia: Import → From URL.
- Swagger Editor (editor.swagger.io): File → Import URL.