DIV CSS 佈局教程網

微信公眾號網頁授權:取得用戶資訊的四個步驟
編輯:關於JavaScript     

要在自己的網頁上取得微信使用者的暱稱、性別、所在地,必須走「網頁授權」(OAuth2)流程。整個過程可以拆成四步,但真正需要寫程式的是第一步與第二步。以下依官方文件順序整理,並標出實作時最容易出錯的地方。

流程總覽

  1. 使用者同意授權,取得 code
  2. 用 code 換取網頁授權 access_token
  3. 重新整理 access_token(若需要)
  4. 拉取使用者資訊(需 scope 為 snsapi_userinfo)

第一步:引導使用者授權,取得 code

前提是公眾帳號必須具備授權作用域(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 解析,而是嚴格比對。

各參數含義:

  • AppID:公眾號的唯一標識
  • REDIRECT_URI:授權後跳轉的位址
  • SCOPE:snsapi_base(不彈出授權頁,直接跳轉,只能取得 openid)或 snsapi_userinfo(彈出授權頁,可取得暱稱、性別、所在地;即使用戶未關注,只要授權也能拿到資訊)
  • STATE:開發者可自訂的 a-zA-Z0-9 參數,用於維持狀態

第二步:用 code 換取 access_token

使用者同意授權後,頁面會跳到 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
  • appid:公眾號唯一標識
  • secret:密鑰
  • code:上一步取得的 code
  • grant_type:固定為 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>

關於 openid

取得 access_token 的同時,回應中也會帶上 openid——使用者的唯一標識。官方文件特別註明:即使用戶未關注公眾號,只要訪問過該公眾號的網頁,也會產生一個對應的 OpenID。

實作上的意義是:openid 可以當作資料庫的查找鍵。使用者若已完成綁定,拿到 openid 後直接查出 user_id 並寫入 session 即可,不必重新拉取一次微信資料。

第三步:重新整理 access_token

這一步通常可以忽略,只在 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
  • access_token:上一步取得的網頁授權 token
  • openid:該公眾號下的使用者唯一標識
<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,回傳的是關注者清單。

實作順序小結

把流程收斂成程式邏輯,其實就是:

  1. 使用者進入頁面 → 檢查有無 code,沒有就導向授權網址
  2. 帶著 code 回來 → 換取網頁授權 access_token 與 openid
  3. 用 openid 查資料庫 → 有綁定就直接登入
  4. 沒綁定且 scope 足夠 → 呼叫 userinfo 取得資料,建立帳號並綁定

釐清「兩個 access_token 用途不同」與「參數順序需嚴格一致」這兩點,這個流程就不容易出錯了。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved