API文档

目录 2.1 1、用户接口 2.1.1 1.1、获取当前登录用户的资料(user/me) 2.1.1 1.2、获取token详细信息(oauth2/get_token_info)

接口列表

1、用户接口

1.1、获取当前登录用户的资料(user/me)

接口说明：

获取当前登录用户的基本资料

访问URL：

OAuth2.0：https://openapi.360.cn/user/me.[json|xml]

访问权限：

请求Access Token时如果没有传递scope参数，则只能获取到当前用户的基本资料(basic)，既返回参数中basic权限的参数（目前只有basic权限）。

返回数据格式：

XML/JSON

是否使用SSL：

OAuth2.0：是

HTTP请求方式：

GET

是否需要登录：

是

请求参数：

参数名	必选	介绍
fields	False	允许用户自定义返回字段，多个属性之间用英文半角逗号作为分隔符。当没有fields参数或为空的时候只返回用户的id、name、avatar属性。查看属性列表

Oauth2.0验证参数：

参数名	必选	介绍
access_token	True	授权的access token

返回参数：

参数名	介绍	当前用户资料权限	默认返回
id	用户ID	basic	true
name	用户名	basic	true
avatar	用户头像	basic	true
sex	用户性别	basic	false
area	用户所在地	basic	false

返回示例：

• JSON示例：

{
  id: "123456"
  name: "test_user_name"
  avatar:"http://u1.qhimg.com/qhimg/quc/48_48/20/01/e5/2001e5q43.3eb2e3.jpg"
}

• XML示例：

<?xml version="1.0" encoding="utf-8" ?>
							<user>
							<id>123456</id>
							<name>test_user_name</name>
							<avatar>http://u1.qhimg.com/qhimg/quc/48_48/20/01/e5/2001e5q43.3eb2e3.jpg</avatar>
							</user>
						

如果需要获得额外的用户信息，请在URL里填写fields参数，如以下URL可以获得id、name、avatar、sex、area的信息：

http(s)://openapi.360.cn/user/me.json?fields=id,name,avatar,sex,area

1.2、获取access_token详细信息

接口说明：

获取传入参数access_token的详细信息,以便校验是否合法

访问URL：

OAuth2.0：https://openapi.360.cn/oauth2/get_token_info.[json|xml]

返回数据格式：

XML/JSON

是否使用SSL：

OAuth2.0：是

HTTP请求方式：

GET

请求参数：

参数名	必选	介绍
access_token	true	待验证的access_token值

返回参数：

参数名	介绍
app_key	该token对应应用的App Key
user_id	用户id
expires_at	access_token失效时间(时间戳)
expires_in	剩余有效时间(秒为单位)
scope	Access Token最终的访问范围，即用户实际授予的权限列表

返回示例：

• JSON示例：

{
							  app_key: "*********"
							  user_id: "2669277834"
							  expires_at: "1465827464"
							  expres_in: "961348"
                              expires_in: "961348"
                              scope: "long"
							}
							

• XML示例：

<?xml version="1.0" encoding="utf-8" ?>
							<oauth2>
							<app_key>*************************</app_key>
							<user_id>2669277834</user_id>
							<expires_at>1465827464</expires_at>
                            <expres_in>960990</expres_in>
                            <expires_in>960990</expires_in>
							<scope>long</scope>
							</oauth2>