登录 | 注册
首页开发文档

API文档

目录

接口列表

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>
						
关闭

Copyright © 2005-2012 360.CN All Rights Reserved.

360安全中心 版权所有