開始開發(fā)
?
第一步:創(chuàng)建企業(yè)應(yīng)用
?
第二步:開啟接收消息模式
?
第三步:獲取access_token
?
第四步:對access_token進(jìn)行緩存處理
?
第五步:開發(fā)應(yīng)用邏輯
?
術(shù)語介紹
corpid:每個企業(yè)都擁有唯一的corpid,獲取此信息可在管理后臺“我的企業(yè)”-“企業(yè)信息”下查看(需要有管理員權(quán)限)
secret:secret是企業(yè)應(yīng)用里面用于保障數(shù)據(jù)安全的“鑰匙”,每一個應(yīng)用都有一個獨立的訪問密鑰,為了保證數(shù)據(jù)的安全,secret務(wù)必不能泄漏。通訊錄接口的密鑰在“管理工具”-“通訊錄同步”里面查看,企業(yè)自定義的應(yīng)用的密鑰可以在企業(yè)應(yīng)用的詳情里面手動生成
access_token:access_token是企業(yè)后臺去企業(yè)微信的后臺獲取信息時的重要票據(jù),所有接口在通信時都需要攜帶此信息用于驗證接口的訪問權(quán)限
開始
第一步:創(chuàng)建企業(yè)應(yīng)用
登錄企業(yè)管理后臺進(jìn)入“企業(yè)應(yīng)用”頁面,通訊錄管理是企業(yè)微信默認(rèn)集成的應(yīng)用,可以直接開啟,如果企業(yè)需要開發(fā)自定義的應(yīng)用,可點擊“添加應(yīng)用”完成應(yīng)用的添加和配置,詳細(xì)步驟請參見應(yīng)用概述。
第二步:開啟接收消息模式
開啟接收消息模式并不是必須步驟,但是如果在你的企業(yè)應(yīng)用中需要用到如下功能時需提前開啟接收消息模式
獲取企業(yè)成員的地理位置信息
動態(tài)調(diào)整企業(yè)應(yīng)用的信息
獲取企業(yè)成員點擊事件類型的應(yīng)用菜單行為
獲取企業(yè)成員通過應(yīng)用給企業(yè)后臺發(fā)送的消息
關(guān)于如何開啟接收消息模式,請閱讀接收消息模式設(shè)置章節(jié)。
第三步:獲取access_token
請求方式:GET(HTTPS)
請求URL:https://qyapi.weixin.qq.com/cgi-bin/gettoken?corpid=id&corpsecret=secrect
參數(shù)說明:
參數(shù)必須說明corpid是企業(yè)IDcorpsecret是應(yīng)用的憑證密鑰
權(quán)限說明:
每個應(yīng)用有獨立的secret,所以每個應(yīng)用的access_token應(yīng)該分開來獲取
返回結(jié)果:
{
"errcode":0,
"errmsg":"",
"access_token":?"accesstoken000001",
"expires_in":?7200
}
參數(shù)說明access_token獲取到的憑證,最長為512字節(jié)expires_in憑證的有效時間(秒)
出錯返回示例:
{
"errcode":40091,
"errmsg":"provider_secret is invalid"
}
第四步:對access_token進(jìn)行緩存處理
為了保障服務(wù)器的穩(wěn)定性,企業(yè)微信對access_token每天的調(diào)用有頻次限制,目前為2000次/天/應(yīng)用,每個access_token的有效期為7200秒(2小時),所以為了防止因為頻率調(diào)用次數(shù)超出限制而影響功能正常使用的問題,建議開發(fā)者將中間生成的access_token 進(jìn)行緩存,過期以后再重新獲取。同時由于企業(yè)微信每個應(yīng)用的access_token是彼此獨立的,所以進(jìn)行緩存時需要區(qū)分應(yīng)用來進(jìn)行存儲。
第五步:開發(fā)應(yīng)用邏輯
到這里,準(zhǔn)備工作已經(jīng)就緒,你可以繼續(xù)閱讀下面的接口文檔了解更多關(guān)于企業(yè)微信提供的開放能力,并將這些能力與你的應(yīng)用進(jìn)行結(jié)合,開始吧!