设备功能接口

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 数据包