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