认证接口 - oauth2_token - 《OSCHINA 开放平台 API 文档》

/action/openapi/token

/action/openapi/token

authorization_code 方式获取 AccessToken

URL

/action/openapi/token

支持格式

JSON JSONP XML

HTTP请求方式

GET/POST

是否需要登录

是

访问授权限制

暂无

授权范围(scope)

暂无

请求参数

	必选	类型及范围	说明	默认值
client_id	true	string	OAuth2客户ID
client_secret	true	string	OAuth2密钥
grant_type	true	string	授权方式：authorization_code或者refresh_token	authorization_code
redirect_uri	true	string	回调地址
code	true	string	调用 /action/oauth2/authorize 接口返回的授权码(grant_type为authorization_code时必选)
refresh_token	false	string	上次调用 /action/oauth2/token 接口返回的refresh_token(grant_type为refresh_token时必选)
dataType	true	string	返回数据类型['json'\|'jsonp'\|'xml']	json
callback	false	string	dataType为 jsonp 时用来指定回调函数	json

注意事项

暂无

返回结果

JSON

{
    "access_token": "8447ff97-9b8c-4224-9cec-63b97d34ba65", 
    "refresh_token": "8447ff97-9b8c-4224-9cec", 
    "token_type": "bearer", 
    "expires_in": 43199,
    "uid": 12
}

返回字段说明

返回值字段	类型及范围	说明
access_token	string	access_token值
refresh_token	string	refresh_token值
token_type	string	access_token类型
expires_in	int	超时时间(单位秒)
uid	int	授权用户的uid

错误说明

错误代码	错误标识	说明
400	invalid_request	无效请求（缺少必要参数）
401	invalid_client	client_id无效
401	invalid_grant	授权方式无效
401	unauthorized_client	应用未授权
401	unsupported_grant_type	不支持的授权方式