>[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
