Главная новость августа: у ToolKeeper появился публичный REST API. До этого данные учёта жили в кабинете и мобильном приложении; теперь с ними можно работать программно — встраивать ToolKeeper в собственные системы, синхронизировать справочники и собирать свои отчёты. Это первый официальный контур интеграций, и он уже на проде.

Как устроен доступ

Ключ формата tk_live_ выпускается в кабинете за минуту: Мой профиль → Настройки аккаунта → API-ключи. У каждого ключа — собственные права (отдельно чтение и запись сотрудников, предметов и рабочих пространств), срок жизни и ограничение по частоте запросов. Ошибки приходят в стандартном формате RFC 9457 — с человеческим объяснением, что именно не так и где смотреть справку. Страница для разработчиков честно раскладывает, что ключ может читать, что может изменять и чего не может никогда.

Что уже можно делать

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

Для массовых операций есть Idempotency-Key: повторный запрос с тем же ключом не создаст дублей. Это то, что отличает «игрушечный» API от производственного: ночные синхронизации и интеграции, которые повторяют запросы при сбоях сети, работают безопасно.

Интерактивная документация со всеми методами и примерами ответов — toolkeeper.io/openapi/v1/docs, страница для разработчиков — toolkeeper.io/developers.

Подключение к 1С — для тех, кто шарит за разработку

Отдельно порадуем бухгалтеров и интеграторов: через открытый API ToolKeeper подключается к 1С. Мы подготовили референсный коннектор на встроенном языке платформы 8.3 — он подходит любой конфигурации: Бухгалтерия, УНФ, ERP, УТ и самописным. Первый вызов — сорок строк кода, которые читают компанию и права ключа; дальше — обмен сотрудниками и предметами пачками, с реестром соответствий и идемпотентностью. Коннектор и пошаговый quickstart передаём партнёрам-интеграторам: напишите на sales@toolkeeper.io, и ваши разработчики получат материалы.

А ещё этим летом

  • Повторные push-напоминания о непринятых передачах: если получатель не принял передачу, система напоминает по цепочке +1, +1, +3, +3, +7, +7 дней — в 10 утра по местному времени и только в рабочие дни.
  • Табличный режим в веб-кабинете: для больших парков ТМЦ — таблица с выбором строк и передачей выбранных предметов в один клик.
  • Выбор ролей при создании сотрудника и поиск по ФИО в фильтре «Ответственные» с кнопкой «показывать удалённых».

API доступен всем клиентам на действующих тарифах — ключи выпускаются в кабинете без отдельных заявок. Начните с бесплатной демо-версии, а если строите интеграцию — вам на страницу разработчика.