“操作员”参数的使用
更新时间:2019-09-26 16:04:13
智慧人居开放平台的云云接口服务中的基础服务API,都需要“操作员”参数。这个参数到底有什么用,又如何使用,本文中来说明这个问题。
基础服务API是开放给云云使用,只能识别到租户级,即appKey/appSecret对应的租户。
有些业务是租户级发起的,比如查询所有用户、所有设备等。还有一些业务,请求来自于C端用户,用户可能是通过APP登录,也可能是通过Web登录。
所以一些场景下,需要云端排查哪个用户发起请求的时候,这个参数会起作用。
操作员
操作员的参数名一般是operator,定义见身份信息,写法如下
{
"operator":{
"hid":"xxxx",
"hidType":"OPEN"
}
}
对于hid值,在身份信息中有如下描述
如果是自建账号,hid=${openId},hidType=OPEN
如果是内置账号,hid=${phone},hidType=OA_PHONE
- C端使用:登录账号的手机号保存在上下文,作为与B端交互的身份标识。B端根据上传的手机号拼装身份信息参数。
服务端调用
一般,服务端会申请一个管理员账号。无论是自建账号还是内置账号,都需要一个表示服务端的账号。
当服务端发起调用时,operator的参数就使用这个固定的管理员账号。
例如,服务需要运行定时任务,从云端API中查询数据作,这时操作员账号填写管理员账号即可。
C端调用
C端请求到服务端时,服务端是可以获取用户信息的。如果使用了内置账号体系,是手机号,如果是自建账号体系,则是openId。
所以,根据身份信息中的描述,由C端调用发起的云端请求,建议把C端的用户,作为operator参数带入服务API中。
作用
当C端业务需要排查时,只需要提供手机号(使用内置账号)或OpenID(使用自建账号)给技术支持同学即可。