h5微信接入授权登录

• 微信提供给开发者的测试账号平台
  • https://mp.weixin.qq.com/debug/cgi-bin/sandboxinfo?action=showinfo&t=sandbox/index
• 微信网页开发文档
  • https://developers.weixin.qq.com/doc/offiaccount/OA_Web_Apps/Wechat_webpage_authorization.html
• 微信JS接口签名校验工具
  • https://mp.weixin.qq.com/debug/cgi-bin/sandbox?t=jsapisign
• 参数

　　https://open.weixin.qq.com/connect/oauth2/authorize?appid=APPID&redirect_uri=REDIRECT_URI&response_type=code&scope=SCOPE&state=STATE#wechat_redirect

• • code
    • code作为换取access_token的票据，每次用户授权带上的code将不一样，code只能使用一次，5分钟未使用自动过期
    • 存在：已授权
    • 不存在：未授权，则跳转微信授权链接，
  • appid（必填）
    • 公众号的唯一标识
  • redirect_url（必填）
    • 授权成功后跳转的地址，微信会跳转到改链接，并通过?的形式拼接code，请使用urlEncode对链接进行处理
  • response_type（必填）
    • 返回类型，请填写code
  • scope（必填）
    • 应用授权作用域
      • 静默授权（scope=snsapi_base）：不弹出授权页面，直接跳转，只能获取用户openid
      • 非静默授权（scope=snsapi_userinfo）：弹出授权页面，可通过openid拿到昵称、性别、所在地，即使在未关注的情况下，只要用户授权，也能获取其信息。
  • state
    • 重定向后会带上state参数，开发者可以填写a-zA-Z0-9的参数值，最多128字节
  • #wechat_redirect（必填）
    • 无论直接打开还是做页面302重定向时，必须带此参数
  • 提示

    • 若提示“该链接无法访问”，请检查参数是否填写错误，是否拥有scope参数对应的授权作用域权限。

    • 由于授权操作安全等级较高，所以在发起授权请求时，微信会对授权链接做正则强匹配校验，如果链接的参数顺序不对，授权页面将无法正常访问。

    • 跳转回调redirect_uri，应当使用https链接来确保授权code的安全性。

• 步骤
  • 用户同意授权，获取code
  • 通过code换区网页授权access_token
    • 获取access_token

      • https://api.weixin.qq.com/sns/oauth2/access_token?appid=APPID&secret=SECRET&code=CODE&grant_type=authorization_code

      •    参数
        • appid（必填，同上）
        • secret（必填）
          • 公众号的appsecret
        • code（必填）
          • 填写第一步获取的code参数
        • grant_type（必填）
          • 填写为authorization_code
    •  正确返回的json数据包

      {
        "access_token":"ACCESS_TOKEN",
        "expires_in":7200,
        "refresh_token":"REFRESH_TOKEN",
        "openid":"OPENID",
        "scope":"SCOPE" 
      }

      • 参数
        • access_toke
          • 网页授权接口调用凭证：此access_token与基础支持的access_token不同
        • expires_in
          • 调用凭证超时时间，单位（秒）
        • refresh_token
          • 用户刷新access_token
        • openid
          • 用户唯一标识，请注意，在未关注公众号时，用户访问公众号的页面，也会产生一个用户和公众号唯一的OpenId
        • scope
          • 用户授权的作用于，使用逗号（，）分隔
    •  错误返回的json数据包

      {"errcode":40029,"errmsg":"invalid code"}

  • 刷新access_token（如果需要）
    • 较短有效期，当超时后，可以使用refresh_token进行刷新，refresh_token有效期为30天，当refresh_token失效后，需要用户重新授权
    • 请求

　　　　　　　　　　 https://api.weixin.qq.com/sns/oauth2/refresh_token?appid=APPID&grant_type=refresh_token&refresh_token=REFRESH_TOKEN

• • • • 参数
        • appid（必填，同上）
        • grant_type（必填）
          • 填写为refresh_token
        • refresh_token（必填）
          • 填写通过access_token获取到的refresh_token参数
      • 正确返回的json数据包

        { 
          "access_token":"ACCESS_TOKEN",
          "expires_in":7200,
          "refresh_token":"REFRESH_TOKEN",
          "openid":"OPENID",
          "scope":"SCOPE" 
        }

        • 参数（参数介绍，同上）
      • 错误返回的json数据包

        {"errcode":40029,"errmsg":"invalid code"}

• • 拉去用户信息（需要scope为snsapi_userinfo）

 

　　　　　　　　https://api.weixin.qq.com/sns/userinfo?access_token=ACCESS_TOKEN&openid=OPENID&lang=zh_CN

• • • 参数
      • aceess_token（同上）
      • openid（同上）
      • lang
        • 返回国家地区语言版本，zh_CN简体，zh_TW繁体，en英语
    • 正确返回的json数据包

      {   
        "openid":" OPENID",
        " nickname": NICKNAME,
        "sex":"1",
        "province":"PROVINCE",
        "city":"CITY",
        "country":"COUNTRY",
        "headimgurl":       "http://thirdwx.qlogo.cn/mmopen/g3MonUZtNHkdmzicIlibx6iaFqAc56vxLSUfpb6n5WKSYVY0ChQKkiaJSgQ1dZuTOgvLLrhJbERQQ4eMsv84eavHiaiceqxibJxCfHe/46",
        "privilege":[ "PRIVILEGE1" "PRIVILEGE2"     ],
        "unionid": "o6_bmasdasdsad6_2sgVt7hMZOPfL"
      }

      • 参数
        • openid（同上）
        • nickname
          • 用户昵称
        • sex
          • 用户性别，1=>男，2=>女，0=>未知
        • province
          • 用户个人资料填写的省份
        • city
          • 普通用户个人资料填写的城市
        • country
          • 国家，如中国为CN
        • headimgurl
          • 用户头像
        • privilege
          • 用户特权信息
        • unionid
          • 只有在用户将公众号绑定到微信开放平台后，才会出现该字段
    • 错误返回的json数据包

      {"errcode":40003,"errmsg":" invalid openid "}

• 附：检验授权凭证（access_token）是否有效

　　　　https://api.weixin.qq.com/sns/auth?access_token=ACCESS_TOKEN&openid=OPENID

• • 参数
    • access_token（同上）
    • openid（同上）
  • 正确返回的json数据包

    { "errcode":0,"errmsg":"ok"}

  • 错误返回的json数据包

    { "errcode":40003,"errmsg":"invalid openid"}