设备接口文档

• 1.1.1. 设备接口文档

1.1.1. 设备接口文档

1）调用方式

client                   http                   InternalService(grpc)
-------------------------------------------------------------------------

http(带Authorization)      -->   根据Authorization进行设备认证或用户认证
                        A  <--   认证失败 500 body为失败原因的字符串
                           或
                           -->   按url推断出InternalService的域名
                                 将body解析成req
                                 填充AccountId, DeviceTypeId, DeviceId(设备认证)或ClientId, UserId(用户认证)
                                 调用resp = grpc(req)
                        B  <--   调用失败 500 body为失败原因的字符串
                           或
                        C  <--   返回200 body为resp

2）认证方式

客户端向httpgw发起请求时，需要在HTTP头部中增加字段Authorization。

设备认证

Authorization

设备认证方式中的Authorization内容格式如下：

version={version};time={time};sign={sign};key={key};device_type_id={device_type_id};device_id={device_id};service={service}

Signature

Authorization中的sign字段是签名串，是对下列组合的字符串（UTF-8编码）做MD5计算

key={key}&device_type_id={device_type_id}&device_id={device_id}&service={service}&version={version}&time={time}&secret={secret}

字段说明

3）接口

地址

https://apigwrest.open.rokid.com

绑定接口 （POST）

/v1/device/deviceManager/bindMaster

参数说明：

返回结果：

{
    "resultCode": 0,
    "message": "success"
}

解绑接口 （POST）

/v1/device/deviceManager/unBindMaster

参数说明：

返回结果：

{
    "resultCode": 0,
    "message": "success"
}