GET /api/v1/gates
Возвращает все шлагбаумы объекта, статус ESP32 и время последней связи.
{
"items": [{
"id": 1,
"name": "Основной въезд",
"online": true,
"last_seen_at": "2026-08-28T17:30:15Z"
}]
}Интегрируйте доступ
в свои сервисы
Dostup.click API позволяет CRM, сайту или приложению создавать гостевые ссылки, получать состояние оборудования, события и статистику объекта.
Авторизация
Создайте отдельный ключ в супер-админке: откройте редактирование объекта и раздел «API-ключи». Ключ действует только в пределах выбранного объекта.
Важно: полный ключ показывается один раз. Храните его как пароль и никогда не размещайте в браузерном JavaScript.
Authorization: Bearer dsk_live_ВАШ_КЛЮЧ
Базовый адрес запросов: https://api.dostup.click/api/v1
Шлагбаумы
Ссылки доступа
GET /api/v1/links
Список ссылок. Параметры: active, limit (до 100), offset.
POST /api/v1/links
Создаёт гостевую ссылку и возвращает готовое поле url.
{
"gate_id": 1,
"label": "Гость — автомобиль 777",
"starts_at": "2026-08-29T09:00:00+05:00",
"ends_at": "2026-08-29T18:00:00+05:00",
"max_uses": 1
}max_uses: null означает неограниченное число использований в пределах срока.
GET /api/v1/links/{id}
Возвращает одну ссылку, её срок, лимит, число использований и состояние.
PATCH /api/v1/links/{id}
Изменяет только переданные поля: gate_id, label, даты, лимит, расписание или active.
{ "label": "Курьер", "max_uses": 2 }DELETE /api/v1/links/{id}
Отключает ссылку. История событий при этом сохраняется.
Для недельного графика передайте
schedule_days (0 — понедельник, 6 — воскресенье), а также schedule_start и schedule_end в формате ЧЧ:ММ.Журнал событий
GET /api/v1/events
Параметры фильтрации: gate_id, from_at, to_at, limit, offset. Ответ содержит пользователя, статус и полный URL снимка, если он сделан.
Статистика
GET /api/v1/stats
Возвращает количество созданных ссылок, всех событий, отправленных команд открытия и отказов. Доступны фильтры from_at и to_at.
Коды ответа
200 / 201Запрос выполнен или ресурс создан.
401Ключ отсутствует, отключён или неверен.
404Ресурс не найден либо не принадлежит объекту.
422Поля запроса заполнены неверно.
{ "detail": "Описание ошибки" }