REST API

Ваш код, читающий HumanR и его кормящий — по токену, не пароль БД

Версионированный REST API ваши системы вызывают с токеном носителя: читайте сотрудников, дни посещения, запросы отпуска, циклы оценки и цели, и ссылочные списки — и отправляйте удары посещения из системы времени, которая говорит ничего, но HTTP. Токены показаны один раз и хранены хэшированы, и токен никогда не может нести разрешение администратор, который выпустил, не держал.

Посмотрите демо — это займёт несколько минут →

Это вам знакомо?

Единственный способ получить данные из это кто-то экспортирует файл и письмо

Система времени или киоск может производить удары, но нет где отправить их

Альтернатива на столе это рука интегратора пароль БД

Учётные данные в этом скрипте было там два года и никто не знает, кто выпустил

Возможности

Что вы получаете

10 возможностей

Токен, который не может превышать, кто выпустил

Объёмы выбраны из чего администратор выпустивший уже держит, так токен сужена копия существующего оператора и никогда путь вокруг. Грант токен посещение-чтение только и то ровно что может сделать — одни разрешение проверки веб-приложение работает применяется без изменения позади конечной точки.

Показано один раз, хранено хэшировано

Сырой токен появляется на экране ровно один раз, при выпуске. Только его хэш хранен, так никто — включая нас — не может читать токен из БД. Потерянный токен отозван и переиздан, вместо восстановления, что правильное поведение и причина это стоит сказать вслух.

Выпущено и отозвано на записи

Каждый выпуск и отзыв написаны к журналу аудита по краткому префиксу токена, никогда его хэш, так год позже вы всё ещё можете ответить кто создал учётные данные сидящие в чьём-то скрипте — без лога сам становящихся место учётные данные утечки.

Читайте сотрудников, посещение, отпуск, производительность и ссылочные данные

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

Отправляйте удары посещения в

Партия ударов отправленная из любой системы, которая может сделать HTTP запрос. Идемпотент на сотруднике и временной метке, так переотправка после выхода времени магазины ничего не дважды, и партия смешивание хорошо и неразрешаемых ряды всё ещё приземляет хорошо и рука остаток коррекции — нет всё-или-ничего сбои на ночной синхроне.

Границы компании токен не может спорить

Объём токена на одну компанию и каждый запрос отфильтрован на неё перед любой параметр запроса читаемый. Звонящий просящий другую компанию ряды получает свою компанию ряды, не ошибка и не чужие данные.

Чувствительные поля остаются позади их разрешение

Зарплата и персональные идентификаторы маскированы в API ответах, если токен несёт чувствительные-данные объём, ровно как они в интерфейсе. Есть нет черный выход где API возвращает больше, чем тот же пользователь видел бы на экране.

Документирована и исследуемо

Генерированный OpenAPI документ и интерактивный исследователь живут позади одной входа, как остальное приложение, так интегратор может читать каждый конечную точку, параметр и форму ответа и попробовать звонок против ваших собственных данных, вместо работы из PDF.

Ограничено скоростью за токен

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

Отсутствует, пока вы не попросили

API за-тенант переключение. С это вниз, каждый маршрут — конечные точки, документы и экран токена подобно — ответы 404, а не 403, так экземпляр, что не включил это выглядит сканеру ровно вроде одного, где функция не существует.

Что-нибудь, что может сделать HTTP запрос

Есть нет коннектор для строить и нет SDK для взять: API простой JSON через HTTPS с токеном носителя, что каждый язык, каждая платформа автоматизации и большинство время-и-доступ системы уже могут говорить.

Your own systems
Inbound API
Time & access systems
Inbound API
OpenAPI / Swagger
Signed HTTP

Всё, что подключает HumanR, туда и оттуда →

Прямо из продукта

Реальные экраны демонстрационной компании — та же система, которую откроет ваш логин.

HumanR API tokens — two active tokens shown by short prefix with their scopes, alongside the issue form listing every available scope
A token is shown once at issue and stored only as a hash — the list can only ever show you its prefix. It carries just the scopes you tick, and only scopes the admin issuing it already holds, so a token can never outgrow the person who created it.

Вопросы

Что API может писать?

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

Чем это отличается от webhooks?

Противоположные направления, и большинство интеграции хотят обе. Webhooks HumanR толкание вам момент что-то случается — запуск зарплаты завершается, разрешение недели от истечения — с нет опросом. API ваш код стянутие на его собственном графике, или толкание удары. Типичная установка подписывает события, что она заботится и звонит API извлечь деталь позади них.

Это безопасно дать продавцу токен?

Безопаснее, чем альтернатива, что обычно получает предложено, что БД логин. Токен несёт только объёмы вы отметьте, может быть прикрепить один компанию, истекает дата вы устанавливаете, ограничено скоростью на его собственном, и отзываемо в один клик без беспокоения кого-то иного интеграции. И потому он никогда не может превышать разрешения администратор выпустивший, взрыва радиус утёкшего токена, граничен человеком вы можете назвать.

Посмотрите на своих реальных данных

Запросите демонстрацию, и мы пришлём вам персональный доступ к полностью загруженной демо-компании — изучите реальные экраны с реалистичными данными за несколько минут.

Без карты. Без звонков продаж. Настоящий логин, отправим на почту.