Robox.Cloud API представляет собой HTTP-сервис для интеграции со сторонними системами.
API работает в режиме сервера.
Обмен данными осуществляется посредством GET- и POST-запросов. Данные передаются в формате JSON.
Для исключения несанкционированного доступа к данным в каждом запросе должен передаваться параметр apiKey , который генерируется в личном кабинете в разделе Настройки -> Интеграция по API. Он представляет собой параметр формата GUID.
apiKey может передаваться двумя способами:
Запрос без apiKey или с ошибочным параметром будет завершаться с ошибкой "Неверный apiKey":
{ "result": false, "error": "Неверный apiKey" }
В личном кабинете доступен конструктор запросов по API, который расположен в раделе Настройки -> Интеграция по API
https://robox.cloud/api/web/get-users-list.ashx?apiKey=123-45
{ 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://robox.cloud/api/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 }, { "device_id": 2201, "uid": 86400671, "device_name": "Офис 720", "is_link": true, "is_params_sync": true }, { "device_id": 1474, "uid": 86401692, "device_name": "Офис 720А", "is_link": true, "is_params_sync": true }, { "device_id": 1257, "uid": 86402132, "device_name": "Офис 718", "is_link": true, "is_params_sync": true } ] } ] }
https://robox.cloud/api/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": "Дверь (гостевой пропуск)", "uid": 1244847, "device_name": "Тестовый КЕДР", "device_id": "Тестовый КЕДР", "object_name": 1474, "object_id": 5, "datetime": "2024-03-24T16:45:58+05:00" } ] }
Максимальный период выборки составляет 100 дней