com.jfinal.weixin.iot.api

## 类 DeviceApi

- java.lang.Object
- - com.jfinal.weixin.iot.api.DeviceApi

-     public class DeviceApi
      extends Object

  设备相关 API

  http://iot.weixin.qq.com/wiki/new/index.html?page=3-4-3 下的API为设备相关API， 测试号可以调用，正式服务号需要申请权限后才能调用。

- - ### 构造器概要

    构造器
    构造器和说明
    `DeviceApi()`

  - ### 方法概要

    所有方法 实例方法 具体方法
    限定符和类型 | 方法和说明
    --- | ---
    `ApiResult` | `authorize(List<DeviceAuth> devices, boolean isCreate, String productId)` 批量授权/更新设备属性 授权后设备才能进行绑定操作
    `ApiResult` | `bind(String tikect, String deviceid, String openid)` 绑定
    `ApiResult` | `compelBind(String deviceid, String openid)` 强制绑定
    `ApiResult` | `createQrcode(List<String> deviceIds)` 根据设备id获取二维码生成串
    `ApiResult` | `createQrcodeNew(String productId)` 根据product_id获取设备id和二维码生成串
    `ApiResult` | `getOpenId(String deviceType, String deviceId)` 根据设备类型和设备id查询绑定的openid
    `ApiResult` | `getStat(String deviceId)` 设备状态查询
    `ApiResult` | `transMsg(String deviceType, String deviceID, String openID, String content)` 向设备推送消息
    `ApiResult` | `unbind(String tikect, String deviceid, String openid)` 解绑
    `ApiResult` | `verifyQrcode(String ticket)` 验证二维码 获取二维码对应设备属性

    - ### 从类继承的方法 java.lang.Object

      `clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait`

- - ### 构造器详细资料

    - #### DeviceApi

          public DeviceApi()

  - ### 方法详细资料

    - #### transMsg

          public ApiResult transMsg(String deviceType,
                                    String deviceID,
                                    String openID,
                                    String content)

      向设备推送消息
      参数:
        `deviceType` - 设备类型，目前为“公众账号原始ID”
        `deviceID` - 设备ID
        `openID` - 微信用户账号的openid
        `content` - 消息内容，BASE64编码
      返回:
        {ApiResult}

    - #### createQrcode

          public ApiResult createQrcode(List<String> deviceIds)

      根据设备id获取二维码生成串
      参数:
        `deviceIds` - 设备id集合
      返回:
        {ApiResult}

    - #### createQrcodeNew

          public ApiResult createQrcodeNew(String productId)

      根据product_id获取设备id和二维码生成串
      参数:
        `productId` - 产品Id
      返回:
        {ApiResult}

    - #### bind

          public ApiResult bind(String tikect,
                                String deviceid,
                                String openid)

      绑定
      参数:
        `tikect` - 二维码生成串
        `deviceid` - 设备id
        `openid` - 微信用户账号的openid
      返回:
        {ApiResult}

    - #### compelBind

          public ApiResult compelBind(String deviceid,
                                      String openid)

      强制绑定
      参数:
        `deviceid` - 设备id
        `openid` - 微信用户账号的openid
      返回:
        {ApiResult}

    - #### unbind

          public ApiResult unbind(String tikect,
                                  String deviceid,
                                  String openid)

      解绑
      参数:
        `tikect` - 二维码生成串
        `deviceid` - 设备id
        `openid` - 微信用户账号的openid
      返回:
        {ApiResult}

    - #### authorize

          public ApiResult authorize(List<DeviceAuth> devices,
                                     boolean isCreate,
                                     String productId)

      批量授权/更新设备属性

      授权后设备才能进行绑定操作

      参数:
        `devices` - 设备属性列表
        `isCreate` - 是否首次授权： true 首次授权； false 更新设备属性
        `productId` - 商品id
      返回:
        {ApiResult}

    - #### getStat

          public ApiResult getStat(String deviceId)

      设备状态查询
      参数:
        `deviceId` - 设备Id

        status 0：未授权 1：已经授权（尚未被用户绑定） 2：已经被用户绑定 {"errcode":0,"errmsg":"ok","status":1,"status_info":"authorized"}

      返回:
        {ApiResult}

    - #### verifyQrcode

          public ApiResult verifyQrcode(String ticket)

      验证二维码 获取二维码对应设备属性
      参数:
        `ticket` - 二维码生成串
      返回:
        {ApiResult}

    - #### getOpenId

          public ApiResult getOpenId(String deviceType,
                                     String deviceId)

      根据设备类型和设备id查询绑定的openid
      参数:
        `deviceType` - 设备类型，目前为“公众账号原始ID”
        `deviceId` - 设备ID
      返回:
        {ApiResult}

Copyright © 2017. All rights reserved.