企業微信API簡易教程

如何創建一個與企業后台互動的自建應用

添加自建應用

1. 登錄企業微信管理后台->應用管理->自建下創建應用，填寫必要的logo，應用名稱，在可見范圍中選擇部門/成員
2. 獲取應用的相關信息agentid和secret；應用里
   
3. 創建完畢可出現在選擇了可見范圍的成員的企業微信終端上。

使用Postman調試api

以發消息為例說明如何調試api接口
調用api的過程，其實就是發送http請求給企業微信后台，在正式開發前，我們可以使用postman模擬http請求調試api。

請求方式：POST（HTTPS）
請求地址： https://qyapi.weixin.qq.com/cgi-bin/message/send?access_token=ACCESS_TOKEN

1. 獲取Secret
   
2. 獲取access_token
   access_token是應用調用api的憑證，由corpid和corpsecret換取

請求方式：GET（HTTPS）
請求URL：https://qyapi.weixin.qq.com/cgi-bin/gettoken?corpid=ID&corpsecret=SECRET

3. 構造消息體（注意是什么請求方式）
可發送文本、圖片、視頻等多種類型的應用消息，這里以最簡單的文本消息為例：（注意修改touser、agentid為自己想要的接收者userid列表、應用id）

{
    "touser": "HuangLong",
    "msgtype": "text",
    "agentid": 1000002,
    "text": {
        "content": "你的快遞已到，請攜帶工卡前往郵件中心領取。\n出發前可查看<a href=\"http://work.weixin.qq.com\">郵件中心視頻實況</a>，聰明避開排隊。"
    },
    "safe": 0,
    "enable_id_trans": 0,
    "enable_duplicate_check": 0,
    "duplicate_check_interval": 1800
}

4. 發送消息
   如下圖示，以上面兩步得到的access_token和消息體為參數，在postman中發送post請求即可
   
   如果發送成功，在接收者的企業微信中的相應應用里，會收到一條文本消息。