API v1

API для разработчиков

Выгружайте оценки, комментарии и итоги по дням в CRM, BI или таблицу. API только читает данные: изменить через него ничего нельзя.

Адрес API: https://trust-eer.ru/api/v1 · ответы в JSON · доступно на тарифе «Бизнес»

Быстрый старт

  1. Откройте в кабинете Настройки → API. Раздел доступен владельцу компании на тарифе «Бизнес».
  2. Введите название, например «amoCRM» или «Power BI», и нажмите «Создать токен».
  3. Скопируйте токен: он начинается с trs_ и показывается один раз. Если потеряли — удалите и создайте новый.
  4. Передавайте токен в заголовке каждого запроса:
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"
    }
  ]
}
Поля ответа
ok
boolean
true, если запрос выполнен.
workspace
object
Компания, к которой относится токен.
workspace.id
string
id компании.
workspace.name
string
Название компании.
items
array
Точки, сначала созданные раньше.
items[].id
string
id точки — для параметра location.
items[].name
string
Название точки.
items[].unit
string или null
Подразделение или адрес.
items[].survey_url
string
Ссылка на опрос, она же в QR-коде.
items[].paused
boolean
true — точка на паузе по тарифу.
items[].responses_total
integer
Оценок за всё время.
items[].created_at
string
Когда создана, ISO 8601 UTC.

ОценкиGET /api/v1/responses

Оценки посетителей с комментариями и контактами, постранично. Подходит для выгрузки в CRM, BI или таблицу. Новые записи — первыми, если не указан order=asc.

Параметры

ПараметрОписание
location
string
id точки из метода /locations. Без параметра — все точки компании.
date_from
ГГГГ-ММ-ДД
С этого дня включительно, ГГГГ-ММ-ДД, по московскому времени.
date_to
ГГГГ-ММ-ДД
По этот день включительно, ГГГГ-ММ-ДД, по московскому времени.
rating
string
Оценки через запятую, от 1 до 5. Например, 1,2,3 — только негатив.
scenario
low | high
low — оценки 1–3 (комментарий владельцу), high — 4–5 (кнопки отзывов на картах).
handled
boolean
true — только обработанные жалобы, false — только необработанные.
limit
integer
Сколько записей вернуть, от 1 до 2000. По умолчанию 200.
offset
integer
Сколько записей пропустить. Для следующей страницы берите pagination.next_offset. По умолчанию 0.
order
desc | 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"
    }
  ]
}
Поля ответа
ok
boolean
true, если запрос выполнен.
workspace
object
Компания, к которой относится токен.
workspace.id
string
id компании.
workspace.name
string
Название компании.
filters
object
Применённые фильтры, как их понял сервер.
filters.date_from
string или null
С какого дня.
filters.date_to
string или null
По какой день.
filters.location
string или null
id точки.
filters.rating
array или null
Оценки.
filters.scenario
string или null
low или high.
filters.handled
boolean или null
Обработана ли жалоба.
filters.limit
integer
Размер страницы.
filters.offset
integer
Сдвиг.
filters.order
string
Порядок сортировки.
stats
object
Итоги по всем записям под фильтром, не только по странице.
stats.total
integer
Всего оценок.
stats.unique
integer
Уникальных посетителей.
stats.non_unique
integer
Повторных оценок от тех же посетителей.
pagination
object
Постраничная выгрузка.
pagination.limit
integer
Размер страницы.
pagination.offset
integer
Сдвиг текущей страницы.
pagination.next_offset
integer или null
offset следующей страницы; null — это последняя страница.
items
array
Оценки.
items[].id
string
id оценки.
items[].location
object
Точка.
items[].location.id
string
id точки.
items[].location.name
string
Название точки.
items[].location.unit
string или null
Подразделение.
items[].rating
integer
Оценка от 1 до 5.
items[].scenario
string
low (1–3) или high (4–5).
items[].comment
string или null
Комментарий посетителя.
items[].contact
string или null
Контакт для ответа, если оставил.
items[].action_id
string или null
id нажатой кнопки отзыва.
items[].action_title
string или null
Кнопка, которую нажал посетитель.
items[].handled_at
string или null
Когда жалоба отмечена обработанной.
items[].handled_by
string или null
Кто обработал.
items[].handled_by_email
string или null
Email того, кто обработал.
items[].handled_note
string или null
Чем закончилось.
items[].created_at
string
Когда поставлена оценка, ISO 8601 UTC.

ИтогиGET /api/v1/summary

Сколько оценок, сколько уникальных посетителей и средняя оценка — всего и по дням (по московскому времени). Удобно для графиков в BI.

Параметры

ПараметрОписание
location
string
id точки из метода /locations. Без параметра — все точки компании.
date_from
ГГГГ-ММ-ДД
С этого дня включительно, ГГГГ-ММ-ДД, по московскому времени.
date_to
ГГГГ-ММ-ДД
По этот день включительно, ГГГГ-ММ-ДД, по московскому времени.
rating
string
Оценки через запятую, от 1 до 5. Например, 1,2,3 — только негатив.
scenario
low | high
low — оценки 1–3 (комментарий владельцу), high — 4–5 (кнопки отзывов на картах).
handled
boolean
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
    }
  ]
}
Поля ответа
ok
boolean
true, если запрос выполнен.
workspace
object
Компания, к которой относится токен.
workspace.id
string
id компании.
workspace.name
string
Название компании.
filters
object
Применённые фильтры, как их понял сервер.
filters.date_from
string или null
С какого дня.
filters.date_to
string или null
По какой день.
filters.location
string или null
id точки.
filters.rating
array или null
Оценки.
filters.scenario
string или null
low или high.
filters.handled
boolean или null
Обработана ли жалоба.
totals
object
Итоги за период.
totals.total
integer
Всего оценок.
totals.unique
integer
Уникальных посетителей.
totals.avg_rating
number или null
Средняя оценка; null, если оценок нет.
daily
array
По дням, только дни с оценками.
daily[].date
string
День, ГГГГ-ММ-ДД.
daily[].cnt
integer
Оценок за день.
daily[].uniq_cnt
integer
Уникальных посетителей за день.
daily[].avg_rating
number
Средняя оценка за день.

Постраничная выгрузка и время

/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Что случилось
400rating: укажите числа от 1 до 5 через запятуюНеверный параметр запроса. В тексте ошибки — какой и что ожидается.
401missing api_tokenТокен не передан: нет заголовка Authorization.
402API доступен на тарифе «Бизнес»Тариф компании не включает API, например, закончилась оплата.
403invalid tokenТакого токена нет: опечатка, или токен удалён в настройках.

Попробовать запрос

Вставьте токен, выберите метод и параметры — ответ появится ниже.

Токен остаётся в этой вкладке: мы его не сохраняем и никуда, кроме запроса к API, не отправляем.

Тот же запрос в терминале

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.