授权后接口调用(UnionID)
通過code獲取access_token
接口說明
通過code獲取access_token的接口。
請求說明 http請求方式:?GET https://api.weixin.qq.com/sns/oauth2/access_token?appid=APPID&secret=SECRET&code=CODE&grant_type=authorization_code參數(shù)說明 參數(shù)是否必須說明 appid????是????應(yīng)用唯一標(biāo)識,在微信開放平臺提交應(yīng)用審核通過后獲得???? secret????是????應(yīng)用密鑰AppSecret,在微信開放平臺提交應(yīng)用審核通過后獲得???? code????是????填寫第一步獲取的code參數(shù)???? grant_type????是????填authorization_code返回說明 正確的返回: {? "access_token":"ACCESS_TOKEN",? "expires_in":7200,? "refresh_token":"REFRESH_TOKEN", "openid":"OPENID",? "scope":"SCOPE"? }參數(shù)說明 access_token????接口調(diào)用憑證???? expires_in????access_token接口調(diào)用憑證超時時間,單位(秒)???? refresh_token????用戶刷新access_token???? openid????授權(quán)用戶唯一標(biāo)識???? scope????用戶授權(quán)的作用域,使用逗號(,)分隔錯誤返回樣例: { "errcode":40029,"errmsg":"invalid?code" }刷新或續(xù)期access_token使用
接口說明
access_token是調(diào)用授權(quán)關(guān)系接口的調(diào)用憑證,由于access_token有效期(目前為2個小時)較短,當(dāng)access_token超時后,可以使用refresh_token進(jìn)行刷新,access_token刷新結(jié)果有兩種:
1. 若access_token已超時,那么進(jìn)行refresh_token會獲取一個新的access_token,新的超時時間;
2.若access_token未超時,那么進(jìn)行refresh_token不會改變access_token,但超時時間會刷新,相當(dāng)于續(xù)期access_token。
refresh_token擁有較長的有效期(30天),當(dāng)refresh_token失效的后,需要用戶重新授權(quán)。
請求方法 使用/sns/oauth2/access_token接口獲取到的refresh_token進(jìn)行以下接口調(diào)用: http請求方式:?GET https://api.weixin.qq.com/sns/oauth2/refresh_token?appid=APPID&grant_type=refresh_token&refresh_token=REFRESH_TOKEN參數(shù)說明
| appid | 是 | 應(yīng)用唯一標(biāo)識 |
| grant_type | 是 | 填refresh_token |
| refresh_token | 是 | 填寫通過access_token獲取到的refresh_token參數(shù) |
| access_token | 接口調(diào)用憑證 |
| expires_in | access_token接口調(diào)用憑證超時時間,單位(秒) |
| refresh_token | 用戶刷新access_token |
| openid | 授權(quán)用戶唯一標(biāo)識 |
| scope | 用戶授權(quán)的作用域,使用逗號(,)分隔 |
接口說明
檢驗授權(quán)憑證(access_token)是否有效
請求說明
http請求方式: GET
https://api.weixin.qq.com/sns/auth?access_token=ACCESS_TOKEN&openid=OPENID參數(shù)說明
| access_token | 是 | 調(diào)用接口憑證 |
| openid | 是 | 普通用戶標(biāo)識,對該公眾帳號唯一 |
獲取用戶個人信息(UnionID機(jī)制)
接口說明
此 接口用于獲取用戶個人信息。開發(fā)者可通過OpenID來獲取用戶基本信息。特別需要注意的是,如果開發(fā)者擁有多個移動應(yīng)用、網(wǎng)站應(yīng)用和公眾帳號,可通過獲 取用戶基本信息中的unionid來區(qū)分用戶的唯一性,因為只要是同一個微信開放平臺帳號下的移動應(yīng)用、網(wǎng)站應(yīng)用和公眾帳號,用戶的unionid是唯一 的。換句話說,同一用戶,對同一個微信開放平臺下的不同應(yīng)用,unionid是相同的。請注意,在用戶修改微信頭像后,舊的微信頭像URL將會失效,因此開發(fā)者應(yīng)該自己在獲取用戶信息后,將頭像圖片保存下來,避免微信頭像URL失效后的異常情況。
請求說明 http請求方式:?GET https://api.weixin.qq.com/sns/userinfo?access_token=ACCESS_TOKEN&openid=OPENID參數(shù)說明
| access_token | 是 | 調(diào)用憑證 |
| openid | 是 | 普通用戶的標(biāo)識,對當(dāng)前開發(fā)者帳號唯一 |
| ? ? ? ?lang | ? 否 | 國家地區(qū)語言版本,zh_CN 簡體,zh_TW 繁體,en 英語,默認(rèn)為zh-CN |
?
| openid | 普通用戶的標(biāo)識,對當(dāng)前開發(fā)者帳號唯一 |
| nickname | 普通用戶昵稱 |
| sex | 普通用戶性別,1為男性,2為女性 |
| province | 普通用戶個人資料填寫的省份 |
| city | 普通用戶個人資料填寫的城市 |
| country | 國家,如中國為CN |
| headimgurl | 用戶頭像,最后一個數(shù)值代表正方形頭像大小(有0、46、64、96、132數(shù)值可選,0代表640*640正方形頭像),用戶沒有頭像時該項為空 |
| privilege | 用戶特權(quán)信息,json數(shù)組,如微信沃卡用戶為(chinaunicom) |
| unionid | 用戶統(tǒng)一標(biāo)識。針對一個微信開放平臺帳號下的應(yīng)用,同一用戶的unionid是唯一的。 |
調(diào)用頻率限制
| 通過code換取access_token | 1萬/分鐘 |
| 刷新access_token | 5萬/分鐘 |
| 獲取用戶基本信息 | 5萬/分鐘 |
轉(zhuǎn)載于:https://blog.51cto.com/pilipala/1717170
總結(jié)
以上是生活随笔為你收集整理的授权后接口调用(UnionID)的全部內(nèi)容,希望文章能夠幫你解決所遇到的問題。
- 上一篇: Debug 之 VS2010网站生成成
- 下一篇: 巧用拦截器:高效的扩展点设计