01: 企業微信API開發前准備

目錄：企業微信API其他篇

01: 企業微信API開發前准備

02：消息推送

03: 通訊錄管理

04：應用管理

目錄：

• 1.1 術語介紹
• 1.2 開發步驟

1.1 術語介紹     返回頂部

　　參考文檔：http://work.weixin.qq.com/api/doc#10013

　　企業微信管理后台： https://work.weixin.qq.com/wework_admin/frame

　　1、corpid：ww2f9a1a85f1806981

　　　　　　每個企業都擁有唯一的corpid，獲取此信息可在管理后台“我的企業”－“企業信息”下查看

　　2、userid：XiaoNaiQiang

　　　　　　每個成員都有唯一的userid，即所謂“帳號”。在管理后台->“通訊錄”->點進某個成員的詳情頁

　　3、部門id：1

　　　　 　　每個部門都有唯一的id，在管理后台->“通訊錄”->“組織架構”->點擊某個部門右邊的小圓點可看到

　　4、tagid：

　　　　　　每個標簽都有唯一的標簽id，在管理后台->“通訊錄”->“標簽”，選中某個標簽，在右上角會有“標簽詳情”按鈕，點擊即可看到

　　5、agentid:

　　　　　　每個應用都有唯一的agentid。在管理后台->“企業應用”->點進應用，即可看到agentid。

       6、secret： corpsecret

　　　　　　1. secret是企業應用里面用於保障數據安全的“鑰匙”，每一個應用都有一個獨立的訪問密鑰，為了保證數據的安全，secret務必不能泄漏。

　　　　　　2. 目前secret有兩種：1. 通訊錄管理secret； 2. 應用secret。

　　　　　　　　1）通訊錄管理secret：在“管理工具”-“通訊錄同步”里面查看（需開啟“API接口同步”）；

                            　　 bvAUJ2OYnjB4eAlCpSdH20AxrjSP6jX60PSGnO6VWuQ

　　　　　　　　2）應用secret：在管理后台->“企業應用”->點進應用，即可看到。

　　7、access_token：

　　　　　　access_token是企業后台去企業微信的后台獲取信息時的重要票據，由corpid和secret產生。

　　　　　　所有接口在通信時都需要攜帶此信息用於驗證接口的訪問權限

1.2 開發步驟     返回頂部

　　參考文檔：http://work.weixin.qq.com/api/doc#10013

　　說明：

　　　　你可以通過以下步驟，使用access_token來訪問企業微信的接口。需要注意的是，所有的接口需使用Https協議、Json數據格式、UTF8編碼。

　　　　注：查看接口說明中，參數中標注大寫的單詞，表示為需要替換的變量

　　1、第一步：創建企業應用並獲取secret

                  1. 通訊錄管理是企業微信默認集成的應用，可以直接開啟。

                  2. 登錄企業管理后台->“管理工具”->“通訊錄同步”->“開啟API接口同步”，即可得到通訊錄接口密鑰。

　　2、第二步：開啟接收消息模式

                  開啟接收消息模式並不是必須步驟，但是如果在你的企業應用中需要用到如下功能時需提前開啟接收消息模式

1. 1. 獲取企業成員的地理位置信息
   2. 動態調整企業應用的信息
   3. 獲取企業成員點擊事件類型的應用菜單行為
   4. 獲取企業成員通過應用給企業后台發送的消息

　　3、第三步：獲取access_token

　　　　　　請求方式：GET（HTTPS）

　　　　　　請求URL：https://qyapi.weixin.qq.com/cgi-bin/gettoken?corpid=ID&corpsecret=SECRECT

　　　　　　注：此處標注大寫的單詞ID和SECRET，為需要替換的變量，根據實際獲取值更新。

　　　　　　查看通訊錄url：https://qyapi.weixin.qq.com/cgi-bin/gettoken?corpid=ww2f9a1a85f1806981&corpsecret=bvAUJ2OYnjB4eAlCpSdH20AxrjSP6jX60PSGnO6VWuQ

　　　　　　參數說明：

參數	必須	說明
corpid	是	企業ID
corpsecret	是	應用的憑證密鑰

 

 

 

 

　　　　　　權限說明：

　　　　　　　　每個應用有獨立的secret，所以每個應用的access_token應該分開來獲取

　　　　　　返回結果：

{
   "errcode":0，
   "errmsg":""，
   "access_token": "accesstoken000001",        # 獲取到的憑證,最長為512字節
   "expires_in": 7200                         # 憑證的有效時間（秒）
}

　　　　　　特別說明：

　　　　　　　　企業微信所有接口，返回包里都有errcode、errmsg。開發者需根據errcode是否為0判斷是否調用成功

　　4、第四步：緩存和刷新access_token

　　　　　　1. 開發者需要緩存access_token，用於后續接口的調用
　　　　　　2. 不能頻繁調用gettoken接口，否則會受到頻率攔截。當access_token失效或過期時，需要重新獲取
　　　　　　3. access_token的有效期通過返回的expires_in來傳達，正常情況下為7200秒（2小時）
　　　　　　4. 有效期內重復獲取返回相同結果，過期后獲取會返回新的access_token。
　　　　　　5. 由於企業微信每個應用的access_token是彼此獨立的，所以進行緩存時需要區分應用來進行存儲。
　　　　　　6. access_token至少保留512字節的存儲空間
　　　　　　7.企業微信可能會出於運營需要，提前使access_token失效，開發者應實現access_token失效時重新獲取的邏輯。

　　5、第五步：開發應用邏輯

　　　　　　到這里，准備工作已經就緒，你可以繼續閱讀下面的接口文檔了解更多關於企業微信提供的開放能力，並將這些能力與你的應用進行結合。