openapi 用于使用授權(quán)碼換取小程序的授權(quán)信息,并換取 access_token和refresh_token。 授權(quán)碼的獲取,需要在用戶在第三方平臺(tái)授權(quán)頁(yè)中完成授權(quán)流程后,在回調(diào) URI 中通過 URL 參數(shù)提供給第三方平臺(tái)方。
說明:
小程序可以自定義選擇部分權(quán)限授權(quán)給第三方平臺(tái),因此第三方平臺(tái)開發(fā)者需要通過該接口來獲取小程序具體授權(quán)了哪些權(quán)限,而不是簡(jiǎn)單地認(rèn)為自己聲明的權(quán)限就是小程序授權(quán)的權(quán)限。
接口調(diào)用請(qǐng)求說明
GET https://openapi.baidu.com/rest/2.0/oauth/token?access_token=ACCESS_TOKEN&code=AUTH_CODE&grant_type=app_to_tp_authorization_code
參數(shù)說明
參數(shù)名 ? ? ? ? ? ? ? 類型 ? 是否必須 ? 描述
access_token ? ?string ? ? ?是 ? ? ?TP的access_token,第三方平臺(tái)接口調(diào)用憑據(jù) ? ?
code ? ? ? ? ? ? ? ?string ? ? ?是 ? ? ?授權(quán)碼 ? ?
grant_type ? ? ? string ? ? ?是 ? ? ?固定字符串: app_to_tp_authorization_code ??
?
返回值說明?
字段名 ? ? ? ? ? ? ? 類型 ? ? ? ? ? ? ? ? 描述
access_token ? ? string ? ?授權(quán)小程序的接口調(diào)用憑據(jù) ? ?
refresh_token ? ?string ? ?接口調(diào)用憑據(jù)刷新令牌,有效期10年,使用后失效 ? ?
expires_in ? ? ? ? ? ?int ? ? ?Access Token的有效期,單位:秒,默認(rèn)1小時(shí) ? ?
返回值示例
{
? ?access_token: "45.1d4146fdea08ab043a2d291b0e2d86ca.3600.1536147748.C1Q38_EEfQjeNhZ1diO5d7hX8Dx_-mVMFst84kTtF6Sn4je",
? ?refresh_token: "46.4d79bd6882af6d2bb238b2f851f3a00f.315360000.1851504148.C1Q38_EEfQjeNhZ1diO5d7hX8Dx_-mVMFst84kTtF6Sn4je",
? ?expires_in: 3600
} ? ?
錯(cuò)誤情況下:
字段名 ? ? ? ? ? ? ? ? ? ? 類型 ? ? ? ? ? ? ? ? 描述
error ? ? ? ? ? ? ? ? ? ? ?string ? ?錯(cuò)誤碼;關(guān)于錯(cuò)誤碼的詳細(xì)信息請(qǐng)參考?http://developer.baidu.com/wiki/index.php?title=docs/oauth/error ? ?
error_description ? ?string ? ?錯(cuò)誤描述信息,用來幫助理解和解決發(fā)生的錯(cuò)誤 ? ?
閱讀本文的人還可以閱讀: