В данной версии API основное изменение – переход на 64-битные идентификаторы карт и передача 64-битных значений в JSON в виде строки
Версия API v.2 работает параллельно с прошлой версией, но доступна по URL
https://kedr.cloud/api/v2/web/
Отправка команды на открытие
Получение списка сотрудников
Получение списка объектов
Получение протокола доступа
Добавление сотрудников
Изменение сотрудников
Удаление сотрудников
Создание гостевого пропуска
https://kedr.cloud/api/v2/web/open.ashx?apiKey=123-45&uid=12345&dir=in&card_code=2388872657
https://kedr.cloud/api/v2/web/open.ashx?apiKey=123-45
{ "uid": 1244847, "dir": "out", "card_code": "2388872657" }
{ "result": true, "uid": 12345, "dir": "in", "card_code": "2388872657", "create_datetime": "2024-05-19T10:29:53+03:00", "exec_datetime": "2024-05-19T10:29:53+03:00" }
https://kedr.cloud/api/v2/web/get-users-list.ashx?apiKey=123-45&card_code=567&user_name=XXX&group_id=0
{ "result": true, "items": [ { "id": 879, "fam": "TEST", "name": "", "otch": "", "phone": "1111111111", "gos_num_auto": "", "card_code": "2100000000", "add_card_code_list": [ "123123", "222", "456" ], "foto_url": "/Foto/508aa05b-3225-442d-964d-307f85fe15aa/8uiPvyBTP7SQYC6fYjlehtvcJUhUZtno.JPG", "change_datetime": "2024-03-26T21:31:43+03:00", "last_accesss_datetime": "2024-02-22T12:01:24+03:00", "blocked": false, "other": "", "group_name": "Без группы", "group_id": -1, "calendar_name": "Без ограничений", "calendar_id": -1, "appointment": "236523", "schedules_list": [ { "schedule_id": 12, "schedule_name": "Инженеры" }, { "schedule_id": 18, "schedule_name": "Производство" } ] } ] }
https://kedr.cloud/api/v2/web/get-objects-list.ashx?apiKey=123-45
{ "result": true, "items": [ { "id": 5, "name": "СпецПромДизайн", "address": "г. Рязань, пр-д Яблочкова, д. 6", "time_zone": 180, "devices_list": [ { "device_id": 1731, "uid": 848848, "device_name": "Офис 717", "is_link": true, "is_params_sync": true, "is_open_for_long_time": false, "user_id": 879, "fam": "TEST", "name": "", "otch": "", "in_out": 200, "datetime": "2024-03-26T21:31:43+03:00", "user_foto_url": "/Foto/508aa05b-3225-442d-964d-307f85fe15aa/8uiPvyBTP7SQYC6fYjlehtvcJUhUZtno.JPG" }, { "device_id": 2201, "uid": 86400671, "device_name": "Офис 720", "is_link": true, "is_params_sync": true, "is_open_for_long_time": false }, { "device_id": 1474, "uid": 86401692, "device_name": "Офис 720А", "is_link": true, "is_params_sync": true, "is_open_for_long_time": false }, { "device_id": 1257, "uid": 86402132, "device_name": "Офис 718", "is_link": true, "is_params_sync": true, "is_open_for_long_time": false } ] } ] }
https://kedr.cloud/api/v2/web/get-access-protocol.ashx?apiKey=123-45&user_name=&uid=0&event_code=-1&beg_date=2024-03-25&end_date=2024-03-25
{ "result": true, "events": [ { "id": 649746, "fam": "", "name": "", "otch": "", "appointment": "", "card_code": "347", "event_code": 200, "event_text": "Дверь (гостевой пропуск)", "is_in_code": true, "uid": 1244847, "urv": false, "device_name": "Тестовый контроллер", "device_id": 2717, "object_name": "Тестовый объект", "object_id": 5, "datetime": "2024-03-24T16:45:58+05:00" } ] }
Максимальный период выборки составляет 100 дней
https://kedr.cloud/api/v2/web/add-users.ashx?apiKey=123-45
{ "items": [ { "fam": "Фролов", "name": "Дмитрий", "otch": "Александрович", "phone": "", "gos_num_auto": "", "card_code": "2388872657", "add_card_code_list": [], "blocked": false, "other": "", "group_name": "SPD", "appointment": "Генеральный директор" } ] }
Максимальное количество сотрудников, которое можно добавить, составляет 3000 человек
Добавлять сотрудников можно как по одному, так и целым списком не более этого лимита
Если такой сотрудник уже есть в системе, то данные по нему просто обновятся. Поиск сотрудника перед обновлением сначала осуществляется по номерам карт доступа, потом по ФИО. П итогу, если сотрудник не найден, то создаётся новый. Если найден, то обновляется информация по текущему.
{ "result": true, "items": [ { "fam": "Фролов", "name": "Дмитрий", "otch": "Александрович", "phone": "", "card_code": "2388872657", "add_card_code_list": [], "status": "replaced" } ] }
При выполнении запроса в ответ будет выдан список сотрудников с соответствующими статусами
https://kedr.cloud/api/v2/web/edit-users.ashx?apiKey=123-45
{ "items": [ { "id": 123, "fam": "Фролов", "name": "Дмитрий", "otch": "Александрович", "phone": "", "gos_num_auto": "", "card_code": "2388872657", "add_card_code_list": [], "blocked": false, "other": "", "group_name": "SPD", "appointment": "Генеральный директор" } ] }
Изменять сотрудников можно как по одному, так и целым списком
{ "result": true, "items": [ { "id": 123, "fam": "Фролов", "name": "Дмитрий", "otch": "Александрович", "phone": "", "card_code": "2388872657", "add_card_code_list": [], "status": "replaced" } ] }
https://kedr.cloud/api/v2/web/del-users.ashx?apiKey=123-45
{ "items": [ { "id": 123, "fam": "", "name": "", "otch": "", "card_code": "9090902" }, { "id": 124, "fam": "Фролова", "name": "Ольга", "otch": "Викторовна" } ] }
Поиск сотрудника будет осуществляться по id, коду карты или по полному совпадению Ф.И.О. в зависимости от того, что именно передано в запросе.
{ "result": false, "items": [ { "id": 123, "fam": "", "name": "", "otch": "", "card_code": "9090902", "status": "not found" }, { "id": 1234, "fam": "Фролова", "name": "Ольга", "otch": "Викторовна", "card_code": "123", "status": "deleted" } ] }
https://kedr.cloud/api/v2/web/create-guest-pass.ashx?apiKey=123-45
{ "uid": 12345, "dir": "in", "beg_dt": "2024-05-19 10:00:00", "end_dt": "2024-05-19 18:00:00", "comment": "Гость", "remote_enable": true }
{ "result": true, "xid": "vku3w86k2e", "uid": 12345, "beg_datetime": "19.05.2024 10:00:00", "end_datetime": "19.05.2024 18:00:00", "remote_enable": true }