PuGoing开发者平台

PuGoing 用户操作接入

一.获取uid

示例：

{
    "op":"mysys",
    "act":"getuid",
    "userName":"XXX",
    "userImg":"XXX",

    "date":{
        "appid":"XXXX",
        "appkey":"XXXXX"
      }
 }

正常响应：

{
    "ack":"1",
    "msg":{
        "uid":"XXXXXXXXXXXXXXX"
      }
 }

参数协议

参数名	参数类型	参数说明	是否必传
op	String	方法类别	是
act	String	方法名	是
userName	String	用户头像	否
userImg	String	用户昵称	否

协议中的date列表

参数名	参数类型	参数说明	是否必传
appid	String	小程序的appid	是
appkey	String	小程序的key	是

二.获取token

示例：

{
    "op":"mysys",
    "act":"auth",
    "date":{
        "appid":"XXXX",
        "appkey":"XXXXX"
      }
 }

正常响应：

{
    "ack":"1",
    "msg":{
        "token":"XXXXXXXXXXXXXXX"
      }
 }

参数协议

参数名	参数类型	参数说明	是否必传
op	String	方法类别	是
act	String	方法名	是

协议中的date列表

参数名	参数类型	参数说明	是否必传
appid	String	联系管理员提供（用于获取token）	是
appkey	String	联系管理员提供（用于获取token）	是

三.配置联网

示例：

{
    "op":"mysys",
    "act":"setwifi",
    "uid":"XXX",
    "date":{
        "account":"XXXX",
        "pwd":"XXXXX"
      }
 }

正常响应：

{
    "ack":"1",
    "msg":{
        "wav":"XXXXXXXXXXXXXXX.wav"
      }
 }

参数协议

参数名	参数类型	参数说明	是否必传
op	String	方法类别	是
act	String	方法名	是
uid	String	获取的微信uid	是

协议中的date列表

参数名	参数类型	参数说明	是否必传
account	String	Wi-Fi的账号（不得包含特殊符号）	是
pwd	String	Wi-Fi的密码（不得包含特殊符号）	否

四.绑定主机获取

示例：（播放音频完成，监听数据）

{
    "op":"mysys",
    "act":"qbind",
    "uid":"XXX",
    "token":"XXXXXXXXXXXXXXXXXXX",
 }

正常响应：

{
    "ack":"1",
    "msg":{
        "did":"XXXXXXXXXXXXXXX"
      }
 }

异常响应：

{
    "ack":"0",
 }

参数协议

参数名	参数类型	参数说明	是否必传
op	String	方法类别	是
act	String	方法名	是
uid	String	获取的微信uid	是
token	String	见二.获取token	是

五.查看当前主机所有的成员

示例：

{
    "op":"mysys",
    "act":"listmeber",
    "uid":"XXX",
    "did":"XXX",
    "token":"XXXXXXXXXXXXXXXXXXX",
 }

正常响应：

{
    "ack":"1",
    "msg":{[
        {
            "name":"用户1",
            "img":"XXXXXXXX",
            "id":"123",
            "pr":"admin",

        },
        {
            "name":"用户2",
            "img":"XXXXXXXX",
            "id":"124",
            "pr":"member",

        }
    ]}
 }

异常响应：

{
    "ack":"0",
 }

参数协议

参数名	参数类型	参数说明	是否必传
op	String	方法类别	是
act	String	方法名	是
uid	String	获取的微信uid	是
did	String	声波联网后获取的did（主机id）	是
token	String	见二.获取token	是

接收参数

参数名	参数类型	参数说明
name	String	用户昵称
img	String	用户头像
pr	String	用户身份（首次绑定主机身份为admin【管理员】，之后通过声波绑定及分享绑定的用户均为member【成员】）
id	String	用户id系统分配（暂无使用）

六.查看已绑定的主机

示例：

{
    "op":"mysys",
    "act":"listrobot",
    "uid":"XXX",
    "token":"XXXXXXXXXXXXXXXXXXX",
 }

正常响应：

{
    "ack":"1",
    "msg":{[
        {
            "name":"主机1",
            "img":"XXXXXXXX",
            "device_id":"XXXXXXXX",
            "num":"XXXXXXXX",
            "use":"1",
            "safemode":"1",
            "pr":"admin",

        },
        {
            "name":"主机2",
            "img":"XXXXXXXX",
            "device_id":"XXXXXXXX",
            "num":"XXXXXXXX",
            "use":"0",
            "safemode":"0",
            "pr":"member",

        }
    ]}
 }

异常响应：

{
    "ack":"0",
 }

参数协议

参数名	参数类型	参数说明	是否必传
op	String	方法类别	是
act	String	方法名	是
uid	String	获取的微信uid	是
token	String	见二.获取token	是

接收参数

参数名	参数类型	参数说明
name	String	主机名（用户设置）
img	String	主机图片（用户设置）
device_id	String	主机ID
num	String	主机的SN：
user	String	用户使用主机情况（1为用户正在使用的主机，0为其他主机）
safemode	String	家里的布防模式（1为离家布防，2为留守布防，0为撤防模式）
pr	String	用户身份（首次绑定主机身份为admin【管理员】，之后通过声波绑定及分享绑定的用户均为member【成员】）

七.切换管家机器人

示例

{
    "op":"mysys",
    "act":"swrobot",
    "uid":"XXX",
    "did":"XXX",
    "token":"XXXXXXXXXXXXXXXXXXX",
    "date":{
        "did":"XXX"
    },

 }

正常响应：

{
    "ack":"1"
 }

异常响应：

{
    "ack":"0",
 }

参数协议

参数名	参数类型	参数说明	是否必传
op	String	方法类别	是
act	String	方法名	是
uid	String	获取的微信uid	是
did	String	正在使用主机的id	是
token	String	见二.获取token	是

date参数协议

参数名	参数类型	参数说明	是否必传
did	String	将要切换的主机id	是

八.查看当前系统信息

示例

{
    "op":"mysys",
    "act":"listsysinfo",
    "uid":"XXX",
    "did":"XXX",
    "token":"XXXXXXXXXXXXXXXXXXX",


 }

正常响应：

{
    "ack":"1",
    "msg":{[
        {
            "name":"主机1",
            "img":"XXXXXXXX",
            "id":"XXXXXXXX",
            "pr":"XXXXXXXX",
        }
 }

异常响应：

{
    "ack":"0",
 }

参数协议

参数名	参数类型	参数说明	是否必传
op	String	方法类别	是
act	String	方法名	是
uid	String	获取的微信uid	是
did	String	正在使用主机的id	是
token	String	见二.获取token	是

返回参数协议

参数名	参数类型	参数说明
ack	String	1为响应成功，0为响应失败
name	String	当前使用的主机名
img	String	当前使用的主机图片
id	String	当前使用的主机id
pr	String	当前使用的主机的身份（admin为管理员，member为成员）

九.查询主机是否在线

示例

{
    "op":"mysys",
    "act":"qonline",
    "uid":"XXX",
    "did":"XXX",
    "token":"XXXXXXXXXXXXXXXXXXX",
 }

正常响应：

{
    "ack":"1",
    "msg":"{
        status:online/offline
    }"
 }

异常响应：

{
    "ack":"0",
 }

参数协议

参数名	参数类型	参数说明	是否必传
op	String	方法类别	是
act	String	方法名	是
uid	String	获取的微信uid	是
did	String	正在使用主机的id	是
token	String	见二.获取token	是

返回参数协议

参数名	参数类型	参数说明	是否必传
ack	String	1为返回返回成功，0为返回错误
status	String	主机在线情况（online在线 offline离线）

十.删除绑定的主机

示例

{
    "op":"mysys",
    "act":"delsysinfo",
    "uid":"XXX",
    "did":"XXX",
    "token":"XXXXXXXXXXXXXXXXXXX",
    "date":{
        "did":"XXX"
    },

 }

正常响应：

{
    "ack":"1"
 }

异常响应：

{
    "ack":"0",
 }

参数协议

参数名	参数类型	参数说明	是否必传
op	String	方法类别	是
act	String	方法名	是
uid	String	获取的微信uid	是
did	String	正在使用主机的id	是
token	String	见二.获取token	是

date参数协议

参数名	参数类型	参数说明	是否必传
did	String	将要切换的主机id	是

十一.移交主机管理权限

示例

{
    "op":"mysys",
    "act":"delsysinfo",
    "uid":"XXX",
    "did":"XXX",
    "token":"XXXXXXXXXXXXXXXXXXX",
    "date":{
        "id":"XXX"
    },

 }

正常响应：

{
    "ack":"1"
 }

异常响应：

{
    "ack":"0",
 }

参数协议

参数名	参数类型	参数说明	是否必传
op	String	方法类别	是
act	String	方法名	是
uid	String	获取的微信uid	是
did	String	正在使用主机的id	是
token	String	见二.获取token	是

date参数协议

参数名	参数类型	参数说明	是否必传
id	String	查看成员所返回的数据中的id（不是uid）	是

十二.移交主机管理权限

示例

{
    "op":"mysys",
    "act":"delmeber",
    "uid":"XXX",
    "did":"XXX",
    "token":"XXXXXXXXXXXXXXXXXXX",
    "date":{
        "id":"XXX"
    },

 }

正常响应：

{
    "ack":"1"
 }

异常响应：

{
    "ack":"0",
 }

参数协议

参数名	参数类型	参数说明	是否必传
op	String	方法类别	是
act	String	方法名	是
uid	String	获取的微信uid	是
did	String	正在使用主机的id	是
token	String	见二.获取token	是

date参数协议

参数名	参数类型	参数说明	是否必传
id	String	查看成员所返回的数据中的id（不是uid）	是

十三.主机不在线时解除绑定关系

示例

{
    "op":"mysys",
    "act":"delsysuser",
    "uid":"XXX",
    "did":"XXX",
    "token":"XXXXXXXXXXXXXXXXXXX",
    "date":{
        "did":"XXX"
    },

 }

正常响应：

{
    "ack":"1"
 }

异常响应：

{
    "ack":"0",
 }

参数协议

参数名	参数类型	参数说明	是否必传
op	String	方法类别	是
act	String	方法名	是
uid	String	获取的微信uid	是
did	String	正在使用主机的id	是
token	String	见二.获取token	是

date参数协议

参数名	参数类型	参数说明	是否必传
did	String	要解绑的主机did	是

附一.更新主机信息

示例

{
    "op":"host",
    "act":"update",
    "uid":"XXX",
    "did":"XXX",
    "token":"XXXXXXXXXXXXXXXXXXX",
    "date":{
        "name":"万科花园",
        "safemode":"0",
        "img":"https:www.12333.com/123.jpg",
    },

 }

正常响应：

{
    "ack":"1"
 }

参数协议

参数名	参数类型	参数说明	是否必传
op	String	方法类别	是
act	String	方法名	是
uid	String	获取的微信uid	是
did	String	正在使用主机的id	是
token	String	见二.获取token	是

date参数协议

参数名	参数类型	参数说明	是否必传
name	String	修改主机的名字（多台主机时做区分）	是
safemode	String	修改主机的布防模式（0 撤防模式 1 离家布防 2 留守布防）	是
img	String	修改主机的图片（多台主机时做区分）	是

附二.获取主机免打扰时间

示例

{
    "op":"host",
    "act":"getmutetime",
    "uid":"XXX",
    "did":"XXX",
    "token":"XXXXXXXXXXXXXXXXXXX"
 }

正常响应：

{

    "ack":"1",
    "msg":"{
        "time":"22:00-7:00"
    }"
 }

参数协议

参数名	参数类型	参数说明	是否必传
op	String	方法类别	是
act	String	方法名	是
uid	String	获取的微信uid	是
did	String	正在使用主机的id	是
token	String	见二.获取token	是

返回参数说明

参数名	参数类型	参数说明
time	String	23:00-07:00（免打扰时间段主机会自动静音）	是

附三.设置主机免打扰时间

示例

{
    "op":"host",
    "act":"getmutetime",
    "uid":"XXX",
    "did":"XXX",
    "token":"XXXXXXXXXXXXXXXXXXX",
    "date":"{
        "time":"22:00-07:00"
    }"

 }

正常响应：

{

    "ack":"1",
    "msg":"{
        "time":"22:00-7:00"
    }"
 }

参数协议

参数名	参数类型	参数说明	是否必传
op	String	方法类别	是
act	String	方法名	是
uid	String	获取的微信uid	是
did	String	正在使用主机的id	是
token	String	见二.获取token	是

date中参数说明

参数名	参数类型	参数说明
time	String	23:00-07:00（免打扰时间段主机会自动静音）	是