优化工单模块，增加企微模块

2024-07-10 15:58:47 +08:00
parent e8512b23e4
commit 6b140fe6dd
134 changed files with 12830 additions and 2 deletions
--- a/sg_wechat_enterprise/we_api/client/api/device.py
+++ b/sg_wechat_enterprise/we_api/client/api/device.py
@@ -0,0 +1,284 @@
+# -*- coding: utf-8 -*-
+from __future__ import absolute_import, unicode_literals
+import base64
+import urllib
+
+from wechatpy.utils import to_text, to_binary
+from wechatpy.client.api.base import BaseWeChatAPI
+
+
+class WeChatDevice(BaseWeChatAPI):
+
+    API_BASE_URL = 'https://api.weixin.qq.com/device/'
+
+    def send_message(self, device_type, device_id, user_id, content):
+        """
+        主动发送消息给设备
+        详情请参考
+        http://iot.weixin.qq.com/document-2_3.html
+
+        :param device_type: 设备类型，目前为“公众账号原始ID”
+        :param device_id: 设备ID
+        :param user_id: 微信用户账号的openid
+        :param content: 消息内容，BASE64编码
+        :return: 返回的 JSON 数据包
+        """
+        content = to_text(base64.b64encode(to_binary(content)))
+        return self._post(
+            'transmsg',
+            data={
+                'device_type': device_type,
+                'device_id': device_id,
+                'openid': user_id,
+                'content': content
+            }
+        )
+
+    def create_qrcode(self, device_ids):
+        """
+        获取设备二维码
+        详情请参考
+        http://iot.weixin.qq.com/document-2_5.html
+
+        :param device_ids: 设备id的列表
+        :return: 返回的 JSON 数据包
+        """
+        return self._post(
+            'create_qrcode',
+            data={
+                'device_num': len(device_ids),
+                'device_id_list': device_ids
+            }
+        )
+
+    def get_qrcode_url(self, ticket, data=None):
+        """
+        通过 ticket 换取二维码地址
+        详情请参考
+        http://iot.weixin.qq.com/document-2_5.html
+
+        :param ticket: 二维码 ticket
+        :param data: 额外数据
+        :return: 二维码地址
+        """
+        url = 'http://we.qq.com/d/{ticket}'.format(ticket=ticket)
+        if data:
+            if isinstance(data, (dict, tuple, list)):
+                data = urllib.urlencode(data)
+            data = to_text(base64.b64encode(to_binary(data)))
+            url = '{base}#{data}'.format(base=url, data=data)
+        return url
+
+    def bind(self, ticket, device_id, user_id):
+        """
+        绑定设备
+        详情请参考
+        http://iot.weixin.qq.com/document-2_12.html
+
+        :param ticket: 绑定操作合法性的凭证（由微信后台生成，第三方H5通过客户端jsapi获得）
+        :param device_id: 设备id
+        :param user_id: 用户对应的openid
+        :return: 返回的 JSON 数据包
+        """
+        return self._post(
+            'bind',
+            data={
+                'ticket': ticket,
+                'device_id': device_id,
+                'openid': user_id
+            }
+        )
+
+    def unbind(self, ticket, device_id, user_id):
+        """
+        解绑设备
+        详情请参考
+        http://iot.weixin.qq.com/document-2_12.html
+
+        :param ticket: 绑定操作合法性的凭证（由微信后台生成，第三方H5通过客户端jsapi获得）
+        :param device_id: 设备id
+        :param user_id: 用户对应的openid
+        :return: 返回的 JSON 数据包
+        """
+        return self._post(
+            'unbind',
+            data={
+                'ticket': ticket,
+                'device_id': device_id,
+                'openid': user_id
+            }
+        )
+
+    def compel_bind(self, device_id, user_id):
+        """
+        强制绑定用户和设备
+        详情请参考
+        http://iot.weixin.qq.com/document-2_12.html
+
+        :param device_id: 设备id
+        :param user_id: 用户对应的openid
+        :return: 返回的 JSON 数据包
+        """
+        return self._post(
+            'compel_bind',
+            data={
+                'device_id': device_id,
+                'openid': user_id
+            }
+        )
+
+    force_bind = compel_bind
+
+    def compel_unbind(self, device_id, user_id):
+        """
+        强制解绑用户和设备
+        详情请参考
+        http://iot.weixin.qq.com/document-2_12.html
+
+        :param device_id: 设备id
+        :param user_id: 用户对应的openid
+        :return: 返回的 JSON 数据包
+        """
+        return self._post(
+            'compel_unbind',
+            data={
+                'device_id': device_id,
+                'openid': user_id
+            }
+        )
+
+    force_unbind = compel_unbind
+
+    def get_stat(self, device_id):
+        """
+        设备状态查询
+        详情请参考
+        http://iot.weixin.qq.com/document-2_7.html
+
+        :param device_id: 设备id
+        :return: 返回的 JSON 数据包
+        """
+        return self._post(
+            'get_stat',
+            data={'device_id': device_id}
+        )
+
+    def verify_qrcode(self, ticket):
+        """
+        验证二维码
+        详情请参考
+        http://iot.weixin.qq.com/document-2_9.html
+
+        :param ticket: 设备二维码的ticket
+        :return: 返回的 JSON 数据包
+        """
+        return self._post(
+            'verify_qrcode',
+            data={'ticket': ticket}
+        )
+
+    def get_user_id(self, device_type, device_id):
+        """
+        获取设备绑定openID
+        详情请参考
+        http://iot.weixin.qq.com/document-2_4.html
+
+        :param device_type: 设备类型，目前为“公众账号原始ID”
+        :param device_id: 设备id
+        :return: 返回的 JSON 数据包
+        """
+        return self._post(
+            'get_openid',
+            data={
+                'device_type': device_type,
+                'device_id': device_id
+            }
+        )
+
+    get_open_id = get_user_id
+
+    def get_binded_devices(self, user_id):
+        """
+        通过openid获取用户在当前devicetype下绑定的deviceid列表
+        详情请参考
+        http://iot.weixin.qq.com/document-2_13.html
+
+        :param user_id: 要查询的用户的openid
+        :return: 返回的 JSON 数据包
+        """
+        return self._post(
+            'get_bind_device',
+            data={'openid': user_id}
+        )
+
+    get_bind_device = get_binded_devices
+
+    def send_status_message(self, device_type, device_id, user_id, status):
+        """
+        主动发送设备状态消息给微信终端
+        详情请参考
+        http://iot.weixin.qq.com/document-2_10.html
+
+        :param device_type: 设备类型，目前为“公众账号原始ID”
+        :param device_id: 设备ID
+        :param user_id: 微信用户账号的openid
+        :param status: 设备状态：0--未连接， 1--已连接
+        :return: 返回的 JSON 数据包
+        """
+        return self._post(
+            'transmsg',
+            data={
+                'device_type': device_type,
+                'device_id': device_id,
+                'open_id': user_id,
+                'device_status': status
+            }
+        )
+
+    def authorize(self, devices, op_type=0):
+        """
+        设备授权
+        详情请参考
+        http://iot.weixin.qq.com/document-2_6.html
+
+        :param devices: 设备信息的列表
+        :param op_type: 请求操作的类型，限定取值为：0：设备授权 1：设备更新
+        :return: 返回的 JSON 数据包
+        """
+        return self._post(
+            'authorize',
+            data={
+                'device_num': len(devices),
+                'device_list': devices,
+                'op_type': op_type
+            }
+        )
+
+    def get_qrcode(self):
+        """
+        获取deviceid和二维码
+        详情请参考
+        http://iot.weixin.qq.com/document-2_11.html
+
+        :return: 返回的 JSON 数据包
+        """
+        return self._get('getqrcode')
+
+    def authorize_device(self, devices, op_type=1):
+        """
+        设备授权
+        详情请参考
+        http://iot.weixin.qq.com/document-2_6.html
+
+        :param devices: 设备信息的列表
+        :param op_type: 请求操作的类型，限定取值为：0：设备授权 1：设备更新
+        :return: 返回的 JSON 数据包
+        """
+        return self._post(
+            'authorize_device',
+            data={
+                'device_num': len(devices),
+                'device_list': devices,
+                'op_type': op_type
+            }
+        )