>[info] 欢迎使用 “蜂泰科技钉钉开放平台”，本平台由 白云飞 负责维护，如遇任何问题，请与其联系。 蜂泰科技钉钉开放平台（以下简称开放平台），主要是为 公司内部系统后续需要接入钉钉通知，扫码登录等钉钉功能提供方便，安全，快捷的接口而存在。 [TOC] ## **目前开放的功能** ### 一、钉钉消息推送 #### 1、普通纯文本消息 >[warning] domain 标识当前的域名+端口 | 说明 | 内容 | | --- | --- | | 接口地址 | http://domain/index/api/ddtextmsg | | 请求方法 | post | 参数说明 | 参数 | 类型 | 说明 | | --- | --- | --- | | user_id | string | 钉钉内用户的唯一id，多个id，通过 ，隔开 | | content | string | 发送的文本内容，不得超过 2048 个字节 | | token | string | 鉴权秘钥 (加密方法，后面会讲解) | * user_id 为钉钉内部的用户id，关于每个用户的对应的 user_id 可以用过 http://domain/admin 下的部门用户管理，进行查看。 >[info] 后续根据实际情况，看看是通过 手机号 还是 查询唯一id。 * token 为请求鉴权秘钥，通过 user_id 与 api_token_key 进行拼接，并进行 md5 加密。 >[info] api_token_key 需要调用接口时，可以找 白云飞 获取 请求返回结果如下 ``` {"code": 0, "data": "", "msg": "ok"} ``` #### 2、带链接的文本消息 | 说明 | 内容 | | --- | --- | | 接口地址 | http://domain/index/api/ddlinkmsg | | 请求方法 | post | 参数说明 | 参数 | 类型 | 说明 | | --- | --- | --- | | user_id | string | 钉钉内用户的唯一id，多个id，通过 ，隔开 | | href | string | 外网可访问的地址 http:// 或者 https:// 全路径 | | title | string | 消息的标题 | | content | string | 发送的文本内容，不得超过 2048 个字节 | | token | string | 鉴权秘钥 (加密方法，后面会讲解) | 请求返回结果如下 ``` {"code": 0, "data": "", "msg": "ok"} ``` #### 返回码说明 | 状态码 | 说明 | | --- | --- | | 0 | 发送成功 | | -1 | access_token获取失败 | | -2 | 钉钉发送消息失败 | | -3 | 参数缺失 | | -4 | 提交的参数中有空值 | | -5 | token无效 | | -6 | 请求方法不对 | >[danger] 注意事项： > 1、企业开发者每分钟最多可调用1500次，ISV开发者每分钟最多可调用200次 2、发送消息单次最多只能给5000人发送 3、每一个微应用给同一员工发送消息，内容相同的消息，一天只能发一次 4、每一个微应用给同一员工发送消息，企业接入方式每个员工每天最多可发送500条，ISV方式最多50条 ### 二、部门以及员工信息的获取 详情请查看 http://domain/admin