多企业授权

TIP

对多企业授权的使用说明，请您先阅读应用开发多企业授权H5使用手册。
了解授权方案后，请您先阅读多企业应用header需传region，再阅读此文档

获取链接访问授权码

接口功能

为安全校验，跳转应用开发多企业授权H5页链接时，每次都需传入有效授权码，每次获取到的授权码2分钟内有效，使用过立即失效。

请求地址

https://open.qly.cmviot.cn/v3/open/api/auth/code/get

请求方式

POST，需要鉴权

请求参数

参数名称	参数类型	是否必需	参数含义	说明

请求示例

{}

响应参数

参数名称	参数类型	参数含义	说明
resultCode	String	响应码	参考响应码定义
resultMsg	String	响应描述
data	CodeObj	响应数据

CodeObj 对象模型

名称	类型	参数含义	说明
code	String	授权码	授权码有效期为2分钟，使用一次后立即失效

响应示例

{
    "resultCode": "000000",
    "resultMsg": "成功",
    "data": {
      "code": "8c936ee38d9f48f5ad0ce7103aee7c76"
    }
}

查询应用已授权企业列表

接口功能

查询应用已取得授权的企业列表。绑定企业为应用创建时填入的企业信息。

请求地址

https://open.qly.cmviot.cn/v3/open/api/region/auth/list

请求方式

POST，需要鉴权

请求参数

参数名称	参数类型	是否必需	参数含义	说明
region	String	N	企业编码	可选，查询指定授权企业的信息
defaultRelation	Integer	N	默认绑定企业标识	可选，本字段不传，返回授权和绑定企业 传值1：仅返回绑定企业的信息 传值0：返回授权企业，不包含绑定企业
page	int	N	页码	默认1
pageSize	int	N	每页大小	默认10，最大100

请求示例

{
    "region": "123456",
    "defaultRelation": 0,
    "page": 1,
    "pageSize": 10
}

响应参数

参数名称	参数类型	参数含义	说明
resultCode	String	响应码	参考响应码定义
resultMsg	String	响应描述
total	int	记录数
page	int	当前页
pageSize	int	页大小
data	List<AuthRegionInfo>	响应数据

AuthRegionInfo 对象模型

名称	类型	参数含义	说明
region	String	企业编码
regionName	String	企业名称
phone	String	超管手机号	RSA+Base64加密,可用开发者私钥解密
expireTime	Long	失效时间	时间戳ms值，null或无该字段返回表示永久失效
opsTime	Long	操作时间	时间戳ms值
defaultRelation	int	默认绑定企业标识	1：是默认绑定企业 0：不是默认绑定企业

响应示例

{
  "resultCode": "000000",
  "resultMsg": "成功",
  "data": [
    {
      "region": "123456",
      "regionName": "我的企业",
      "phone": "TP+7WWmAaPhMPsvvUTXNzX9RnLdzXOplIak9JFPyUXUq7RrBS31klhnPsF7LvnAcAgjW0kVc6FbxqbNEhurwk1ElykprUo05DuLsLV6H7O5lJ6IG3H1iJ4V/IcWIbCv3WIFGwDz0mppnvPtNIKy19Tu6YlaZsnmWRx0dczjSvOg=",
      "opsTime": 1741928512000,
      "defaultRelation": 0
    }
  ],
  "total": 1,
  "page": 1,
  "pageSize": 10
}