要在自己的網頁上取得微信使用者的暱稱、性別、所在地,必須走「網頁授權」(OAuth2)流程。整個過程可以拆成四步,但真正需要寫程式的是第一步與第二步。以下依官方文件順序整理,並標出實作時最容易出錯的地方。
snsapi_userinfo)前提是公眾帳號必須具備授權作用域(scope)的權限。服務號獲得高級介面後,預設擁有 snsapi_base 與 snsapi_userinfo。接著引導關注者打開這個網址:
https://open.weixin.qq.com/connect/oauth2/authorize?appid=APPID&redirect_uri=REDIRECT_URI&response_type=code&scope=SCOPE&state=STATE#wechat_redirect
若出現「該鏈接無法訪問」的提示,請檢查參數是否填寫正確,以及是否擁有該 scope 對應的授權權限。
這裡有一個非常容易忽略的細節:由於授權操作的安全等級較高,微信會對授權鏈接做正則強匹配校驗。也就是說,參數的順序必須與文件一致,順序錯了授權頁面就直接打不開。這不是寬鬆的 query string 解析,而是嚴格比對。
各參數含義:
snsapi_base(不彈出授權頁,直接跳轉,只能取得 openid)或 snsapi_userinfo(彈出授權頁,可取得暱稱、性別、所在地;即使用戶未關注,只要授權也能拿到資訊)使用者同意授權後,頁面會跳到 redirect_uri/?code=CODE&state=STATE。其中 state 就是前面傳入的 STATE 原樣回傳。
先取出 code:
<code class="hljs php">$code = I('get.code');
if (empty($code)) {
//todo 非微信訪問
exit('</code>');
} else {
//授權後操作
}</code>
接著請求這個位址換取 access_token:
https://api.weixin.qq.com/sns/oauth2/access_token?appid=APPID&secret=SECRET&code=CODE&grant_type=authorization_code
authorization_code注意這裡的端點是 /sns/oauth2/access_token,不是 /cgi-bin/token。兩者用途不同:前者是網頁授權用的、帶有使用者身分;後者是全域的介面憑證。混用是最常見的錯誤之一。
這裡 access_token 可以做快取處理,避免頻繁請求。以 ThinkPHP 為例:
<code class="hljs php">$access_token = S('access_token');
if (empty($access_token)) {
$url = 'https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid='
. C('wechat.AppID') . '&secret=' . C('wechat.AppSecret');
$str = file_get_contents($url);
$str = json_decode($str, true);
$access_token = $str['access_token'];
S('access_token', $access_token, 3600);
}</code>
取得 access_token 的同時,回應中也會帶上 openid——使用者的唯一標識。官方文件特別註明:即使用戶未關注公眾號,只要訪問過該公眾號的網頁,也會產生一個對應的 OpenID。
實作上的意義是:openid 可以當作資料庫的查找鍵。使用者若已完成綁定,拿到 openid 後直接查出 user_id 並寫入 session 即可,不必重新拉取一次微信資料。
這一步通常可以忽略,只在 token 真的過期時重新走一次第二步即可。實務上建議快取 token 並留出緩衝時間主動更新,而不是等它失效。
如果資料庫裡查不到這個微信帳號的綁定紀錄,代表是首次登入。此時(且授權 scope 為 snsapi_userinfo)就能用 access_token 與 openid 拉取詳細資料:
http:GET(請使用 https 協議) https://api.weixin.qq.com/sns/userinfo?access_token=ACCESS_TOKEN&openid=OPENID&lang=zh_CN
<code class="hljs php">$url = "https://api.weixin.qq.com/sns/user/info?access_token=$access_token&openid=$openid&lang=zh_CN";
$str = file_get_contents($url);
$str = json_decode($str, true);
if (empty($str['errcode'])) {
//建立 user 並綁定 openid
} else {
//錯誤處理
}</code>
同樣地,端點是 /sns/userinfo 而不是 /cgi-bin/user/info。前者帶使用者身分、回傳個人資料;後者只需要全域 token,回傳的是關注者清單。
把流程收斂成程式邏輯,其實就是:
釐清「兩個 access_token 用途不同」與「參數順序需嚴格一致」這兩點,這個流程就不容易出錯了。