12 октября 2020 г. 13:21
download Selock API
Способы получения данных клиента по токену
Через POST запрос доступны следующие пользовательские данные:
Мы ожидаем POST запрос следующего вида:
url: https://selock.co/api/v1/get_data/
data: { 'token': <selockToken>, 'keys': ['locks', 'guests', 'rooms', 'categories', 'statuses', 'orders', 'sources'], }
В списке keys нужно указать ключи для нужных вам данных
Ответы Selock:
Ошибки:
Пример ответа с данными номеров:
{
'result': True,
'data': {
'rooms': [
{'name': 'Апартаменты', 'lock': '1111111', 'status': 'Убрано', 'id': 1, 'category': 'Стандарт'},
{'name': 'Номер 1', 'lock': None, 'status': 'Убрано', 'id': 2, 'category': 'Люкс'}
],
}
}
Срабатывает, когда заряд батареи опускается ниже 20%
Подписаться:
https://selock.co/api/v1/zaiper/subscribe/battery/
https://selock.co/api/v1/zaiper/unsubscribe/battery/
С вашим Selock токеном и урлом в body:
"hookUrl": "<hook-url>",
"token": "<token>"
Пример того, что мы отправляем в POST:
Срабатывает, когда Sciener отправляет коллбек с изменением статуса замка
Подписаться:
https://selock.co/api/v1/zaiper/subscribe/locks/
https://selock.co/api/v1/zaiper/unsubscribe/locks/
С вашим Selock токеном и урлом в body:
"hookUrl": "<hook-url>",
"token": "<token>"
Пример того, что мы отправляем в POST:
Мы пересылаем данные колбека c Sciener
https://open.sciener.com/doc/api/v3/lockRecord/notify/
Срабатывает, когда Sciener присылает коллбек со статусом "удачное открытие"
Подписаться:
https://selock.co/api/v1/zaiper/subscribe/locks_open/
https://selock.co/api/v1/zaiper/unsubscribe/locks_open/
С вашим Selock токеном и урлом в body:
"hookUrl": "<hook-url>",
"token": "<token>"
Пример того, что мы отправляем в POST:
Мы пересылаем данные колбека c Sciener
https://open.sciener.com/doc/api/v3/lockRecord/notify/
Срабатывает, когда Sciener присылает коллбек со статусом "удачное закрытие"
Подписаться:
https://selock.co/api/v1/zaiper/subscribe/locks_close/
https://selock.co/api/v1/zaiper/unsubscribe/locks_close/
С вашим Selock токеном и урлом в body:
"hookUrl": "<hook-url>",
"token": "<token>"
Пример того, что мы отправляем в POST:
Мы пересылаем данные колбека c Sciener
https://open.sciener.com/doc/api/v3/lockRecord/notify/
Срабатывает, когда в Selock создан новый ордер
Подписаться:
https://selock.co/api/v1/zaiper/subscribe/orders/
https://selock.co/api/v1/zaiper/unsubscribe/orders/
С вашим Selock токеном и урлом в body:
"hookUrl": "<hook-url>",
"token": "<token>",
"order_fields": ["confirmed", ]
Значения, принимаемые в списке order_fields:
Пример того, что мы отправляем в POST:
Срабатывает, когда заказ в Selock был изменён
Подписаться:
https://selock.co/api/v1/zaiper/subscribe/orders_change/
https://selock.co/api/v1/zaiper/unsubscribe/orders_change/
С вашим Selock токеном и урлом в body:
"hookUrl": "<hook-url>",
"token": "<token>",
"order_change_fields": ["confirmed", ]
Значения, принимаемые в списке order_change_fields:
Пример того, что мы отправляем в POST:
'title': 'Ордер!',
Меняет статус замка
url:
https://selock.co/api/v1/zaiper/change_lock_status/
ожидаем внутри body запроса:
Изменения заказа Selock
url:
https://selock.co/api/v1/zaiper/change_order/
ожидаем внутри body запроса:
Создание вашего заказа в Selock
url:
https://selock.co/api/v1/zaiper/create_order/
ожидаем внутри body запроса:
при удачном создании заказа, вернётся: