设备功能接口

class wechatpy.client.api.WeChatDevice(client=None)

authorize(devices, op_type=1)

设备授权 详情请参考 https://iot.weixin.qq.com/wiki/new/index.html?page=3-4-5

参数

• devices – 设备信息的列表

• op_type – 请求操作的类型，限定取值为：0：设备授权 1：设备更新

返回

返回的 JSON 数据包

bind(ticket, device_id, user_id)

绑定设备 详情请参考 https://iot.weixin.qq.com/wiki/new/index.html?page=3-4-7

参数

• ticket – 绑定操作合法性的凭证（由微信后台生成，第三方H5通过客户端jsapi获得）

• device_id – 设备id

• user_id – 用户对应的openid

返回

返回的 JSON 数据包

compel_bind(device_id, user_id)

强制绑定用户和设备 详情请参考 https://iot.weixin.qq.com/wiki/new/index.html?page=3-4-7

参数

• device_id – 设备id

• user_id – 用户对应的openid

返回

返回的 JSON 数据包

compel_unbind(device_id, user_id)

强制解绑用户和设备 详情请参考 https://iot.weixin.qq.com/wiki/new/index.html?page=3-4-7

参数

• device_id – 设备id

• user_id – 用户对应的openid

返回

返回的 JSON 数据包

create_qrcode(device_ids)

获取设备二维码 详情请参考 https://iot.weixin.qq.com/wiki/new/index.html?page=3-4-4

参数

device_ids – 设备id的列表

返回

返回的 JSON 数据包

force_bind(device_id, user_id)

强制绑定用户和设备 详情请参考 https://iot.weixin.qq.com/wiki/new/index.html?page=3-4-7

参数

• device_id – 设备id

• user_id – 用户对应的openid

返回

返回的 JSON 数据包

force_unbind(device_id, user_id)

强制解绑用户和设备 详情请参考 https://iot.weixin.qq.com/wiki/new/index.html?page=3-4-7

参数

• device_id – 设备id

• user_id – 用户对应的openid

返回

返回的 JSON 数据包

get_bind_device(user_id)

通过openid获取用户在当前devicetype下绑定的deviceid列表 详情请参考 https://iot.weixin.qq.com/wiki/new/index.html?page=3-4-12

参数

user_id – 要查询的用户的openid

返回

返回的 JSON 数据包

get_binded_devices(user_id)

通过openid获取用户在当前devicetype下绑定的deviceid列表 详情请参考 https://iot.weixin.qq.com/wiki/new/index.html?page=3-4-12

参数

user_id – 要查询的用户的openid

返回

返回的 JSON 数据包

get_open_id(device_type, device_id)

获取设备绑定openID 详情请参考 https://iot.weixin.qq.com/wiki/new/index.html?page=3-4-11

参数

• device_type – 设备类型，目前为“公众账号原始ID”

• device_id – 设备id

返回

返回的 JSON 数据包

get_qrcode(product_id=1)

获取deviceid和二维码 详情请参考 https://iot.weixin.qq.com/wiki/new/index.html?page=3-4-4

参数

product_id – 设备的产品编号

返回

返回的 JSON 数据包

get_qrcode_url(ticket, data=None)

通过 ticket 换取二维码地址 详情请参考 https://iot.weixin.qq.com/wiki/new/index.html?page=3-4-4

参数

• ticket – 二维码 ticket

• data – 额外数据

返回

二维码地址

get_stat(device_id)

设备状态查询 详情请参考 https://iot.weixin.qq.com/wiki/new/index.html?page=3-4-8

参数

device_id – 设备id

返回

返回的 JSON 数据包

get_user_id(device_type, device_id)

获取设备绑定openID 详情请参考 https://iot.weixin.qq.com/wiki/new/index.html?page=3-4-11

参数

• device_type – 设备类型，目前为“公众账号原始ID”

• device_id – 设备id

返回

返回的 JSON 数据包

send_message(device_type, device_id, user_id, content)

主动发送消息给设备 详情请参考 https://iot.weixin.qq.com/wiki/new/index.html?page=3-4-3

参数

• device_type – 设备类型，目前为“公众账号原始ID”

• device_id – 设备ID

• user_id – 微信用户账号的openid

• content – 消息内容，BASE64编码

返回

返回的 JSON 数据包

send_status_message(device_type, device_id, user_id, msg_type, device_status)

第三方主动发送设备状态消息给微信终端 详情请参考 https://iot.weixin.qq.com/wiki/document-2_10.html

参数

• device_type – 设备类型，目前为“公众账号原始ID”

• device_id – 设备ID

• user_id – 微信用户账号的openid

• msg_type – 消息类型：2–设备状态消息

• status – 设备状态：0–未连接， 1–已连接

返回

返回的 JSON 数据包

unbind(ticket, device_id, user_id)

解绑设备 详情请参考 https://iot.weixin.qq.com/wiki/new/index.html?page=3-4-7

参数

• ticket – 绑定操作合法性的凭证（由微信后台生成，第三方H5通过客户端jsapi获得）

• device_id – 设备id

• user_id – 用户对应的openid

返回

返回的 JSON 数据包

verify_qrcode(ticket)

验证二维码 详情请参考 https://iot.weixin.qq.com/wiki/new/index.html?page=3-4-9

参数

ticket – 设备二维码的ticket

返回

返回的 JSON 数据包