“操作员”参数的使用

更新时间: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(使用自建账号)给技术支持同学即可。

results matching ""

    No results matching ""