open api

开发者可以使用open api调用系统后端服务,返回json数据格式。授权管理设备管理用户管理

成功时,state为1,data为返回数据;失败时state为-1,data为错误描述
{
    state:1
    data:{...}
}
                            

获取token

请求地址:GET /api/get_token
请求参数:
参数名 类型 必填 说明
clientKey string 必填 开发者key
clientSecret string 必填 开发者Secret
响应参数:
参数名 类型 说明
accessToken string 访问token
refreshToken string 刷新token
expiredIn integer 过期时间,秒为单位

刷新token

请求地址:GET /api/refresh_token
请求参数:
参数名 类型 必填 说明
clientKey string 必填 开发者key
refreshToken string 必填 刷新token
响应参数:
参数名 类型 说明
accessToken string 访问token
refreshToken string 刷新token
expiredIn integer 过期时间,秒为单位

获取设备列表

请求地址:GET /api/device/list
请求参数:
参数名 类型 必填 说明
clientKey string 必填 开发者key
accessToken string 必填 访问token
openId string 选填 用户id,默认返回管理者的设备
cursor integer 必填 分页游标
count integer 必填 页大小
响应参数:
参数名 类型 说明
list array 设备数据
total integer 设备总数量
list类型:
名称 类型 说明
uuid string 设备uuid
name string 设备名
phoneNumber string 设备手机号
extraData json object string 用于存放开发者自定义数据
enable boolean 设备是否可用,false表示设备目前不可用
days integer 可用天数
onlineState integer 工作状态,0表示离线,1表示在线,2表示在线但服务不可用
workState integer 工作状态,0表示空闲,1表示繁忙
devState integer 开发模式,0表示开发模式,1表示发布模式

启动设备

请求地址:GET /api/device/start
请求参数:
参数名 类型 必填 说明
clientKey string 必填 开发者key
accessToken string 必填 访问token
uuid string 必填 设备uuid
响应参数:
参数名 类型 说明

停止设备

请求地址:GET /api/device/stop
请求参数:
参数名 类型 必填 说明
clientKey string 必填 开发者key
accessToken string 必填 访问token
uuid string 必填 设备uuid
响应参数:
参数名 类型 说明

获取用户信息

请求地址:GET /api/user/info
请求参数:
参数名 类型 必填 说明
clientKey string 必填 开发者key
accessToken string 必填 访问token
openId string 选填 用户id,默认获取当前管理员的信息
响应参数:
参数名 类型 说明
openId string 用户id
username string 用户名
phoneNumber string 电话号码
email string 电子邮箱
wx string 微信号
createTime integer 创建时间

创建用户

请求地址:POST /api/user/create
URL请求参数:
参数名 类型 必填 说明
clientKey string 必填 开发者key
accessToken string 必填 访问token
Body请求参数:
Content-Type: application/json
参数名 类型 必填 说明
username string 必填 用户名
password string 选填 密码
phoneNumber string 选填 电话号码
wx string 选填 微信号
响应参数:
参数名 类型 说明
openId string 用户id

用户登录

请求地址:GET /api/user/login
请求参数:
参数名 类型 必填 说明
clientKey string 必填 开发者key
accessToken string 必填 访问token
username string 必填 用户名
password string 必填 密码
响应参数:
参数名 类型 说明
openId string 用户id
username string 用户名
phoneNumber string 电话号码
email string 电子邮箱
wx string 微信号
createTime integer 创建时间

获取用户列表

请求地址:GET /api/user/list
请求参数:
参数名 类型 必填 说明
clientKey string 必填 开发者key
accessToken string 必填 访问token
cursor integer 必填 分页游标
count integer 必填 页大小
响应参数:
参数名 类型 说明
list array 用户数据
total integer 用户总数量
list类型:
名称 类型 说明
openId string 用户id
username string 用户名
phoneNumber string 电话号码
email string 电子邮箱
wx string 微信号
createTime integer 创建时间

调用自定义后端微服务

请求地址:GET /api/call_micro_service
请求参数:
参数名 类型 必填 说明
clientKey string 必填 开发者key
accessToken string 必填 访问token
name string 必填 接口名
isDev boolean 选填 是否为开发模式,默认值false
params json array string 选填 接口参数,接口参数和接口对应的后端脚本参数一致。注意这里在调用之前需要encodeUri
响应参数:
参数名 类型 说明
return object 接口返回值和接口对应脚本的返回值一致
Copyright © 2021 冰狐智能辅助. All rights reserved.