Владельцу

API-клиенты и OpenAPI

Как выдать интеграции ограниченный программный доступ и проверить запрос по актуальной документации FixTech.

Как выдать интеграции ограниченный программный доступ и проверить запрос по актуальной документации FixTech.

Кому подходит: инструкция для владельца или управляющего. Перед изменениями убедитесь, что выбрано нужное заведение.

Перед началом

  • Войдите в нужный личный кабинет и проверьте название заведения в верхней части страницы.
  • Подготовьте данные, которые будете вводить. Для настроек с оплатой и интеграциями также понадобятся реквизиты поставщика.
  • Если нужного пункта нет, проверьте тариф и права вашей роли.

Как выполнить настройку

  1. Создайте API-клиента. выберите tenant, филиалы, срок действия и только необходимые scopes
  2. Сохраните секрет. он показывается один раз; передавайте его по защищённому каналу и храните вне исходного кода
  3. Откройте документацию. используйте api.fixtech-dev.ru/docs и openapi.json для доступных маршрутов и схем
  4. Проверьте запросы. передавайте bearer token, X-Correlation-ID и Idempotency-Key для изменяющих операций, затем сохраните журнал ответа
Раздел интеграций
Раздел интеграций: ориентируйтесь на названия разделов, значения в вашем аккаунте могут отличаться.

Как проверить результат

Клиент не читает чужой tenant или филиал, запрещённый scope возвращает унифицированную ошибку, повтор с тем же ключом не создаёт вторую операцию, а отозванный token перестаёт работать.

Если не получается

  • Обновите страницу и повторно выберите заведение: часть данных показывается только в его контексте.
  • Проверьте обязательные поля, формат телефона, даты и числовые значения. Ошибка сохранения появляется справа под шапкой.
  • Не создавайте дубль сразу после медленного ответа. Сначала откройте список и убедитесь, что запись не появилась.

Выберите язык