API接口文档
第11行: | 第11行: | ||
'''API通用说明''' | '''API通用说明''' | ||
− | #''' | + | #'''云登入API''' |
− | + | 下面的几个部分详细描述了你需要向云登入的服务器发起的API调用接口。接下来的部分先讨论一般的请求(request)和回应(response)格式,以及针对每个API调用的报错情况。 | |
#'''请求(request)格式''' | #'''请求(request)格式''' | ||
− | + | 每个从云登入API调用都以一个对应下表中的基础URL的HTTP POST开始。而且,每个调用方法都附了一个名称,以及一组必填或选填的参数。 | |
<div> | <div> | ||
第28行: | 第28行: | ||
====用户类接口==== | ====用户类接口==== | ||
+ | [[获取用户信息|user_info]] 获取用户信息 | ||
+ | |||
+ | 可以通过user_info接口获取到平台供应商提供的用户信息,包括姓名、性别、爱好、好友、地址等等。 | ||
+ | |||
====绑定类接口==== | ====绑定类接口==== | ||
+ | [[平台账号绑定|bind]] 平台账号绑定 | ||
+ | |||
+ | 可以通过bind接口使用户的平台账号和网站本身账号或者平台账号之间实现绑定。 | ||
+ | |||
+ | |||
+ | [[平台账号解除绑定|unbind]] 平台账号解除绑定 | ||
+ | |||
+ | 可以通过unbind接口使用户的平台账号和网站本身账号或者平台账号之间解除绑定。 | ||
+ | |||
+ | |||
+ | [[全部解除绑定|all_unbind]] 全部解除绑定 | ||
+ | |||
+ | 可以通过all_unbind接口使用户的所有账号绑定关系全部解除。 | ||
+ | |||
+ | |||
+ | [[获取绑定关系|bind_info]] 获取绑定关系 | ||
+ | |||
+ | 可以通过bind_info接口获取到用户的所有平台账号绑定关系,即使此用户并没有在你的网站上进行过绑定。 | ||
+ | |||
====好友类接口==== | ====好友类接口==== | ||
+ | [[获取可邀请好友列表|friends]] 获取可邀请好友列表 | ||
+ | |||
+ | 可以通过friends接口获取用户绑定的平台账号上的所有未访问过你网站的好友信息。 | ||
+ | |||
+ | |||
+ | [[获取站内好友列表|recommend_user]] 获取站内好友列表 | ||
+ | |||
+ | 可以通过recommend_user接口获取用户绑定的平台账号上的所有已经访问过你网站的好友信息。 | ||
+ | |||
+ | |||
+ | [[发送好友邀请|invite]] 发送好友邀请 | ||
+ | |||
+ | 可以通过invite接口向用户的好友发送邀请,根据不同平台发送的形式有所不同。 | ||
+ | |||
====同步类接口==== | ====同步类接口==== | ||
+ | [[发送登录新鲜事|send_login_feed]] 发送登录新鲜事 | ||
+ | |||
+ | 可以通过send_login_feed接口在用户使用平台账号登录网站时,向该平台发送一条登录信息。 | ||
+ | |||
+ | [[同步信息|share]] 同步信息 | ||
+ | |||
+ | 用户可以通过share接口在用户发布帖子、日志、评论等信息时,把此信息同步到用户绑定的多个平台上。 | ||
+ | |||
====其他类接口==== | ====其他类接口==== | ||
[[获取已选择平台供应商|get_media]] 获取已选择平台供应商 | [[获取已选择平台供应商|get_media]] 获取已选择平台供应商 | ||
用户可以通过get_media接口获取已经选择的所有平台供应商 | 用户可以通过get_media接口获取已经选择的所有平台供应商 |
2012年4月27日 (五) 10:27的版本
API通用说明
- 云登入API
下面的几个部分详细描述了你需要向云登入的服务器发起的API调用接口。接下来的部分先讨论一般的请求(request)和回应(response)格式,以及针对每个API调用的报错情况。
- 请求(request)格式
每个从云登入API调用都以一个对应下表中的基础URL的HTTP POST开始。而且,每个调用方法都附了一个名称,以及一组必填或选填的参数。
基础API的URL http://open.denglu.cc/api/v3/method-name
用户类接口
user_info 获取用户信息
可以通过user_info接口获取到平台供应商提供的用户信息,包括姓名、性别、爱好、好友、地址等等。
绑定类接口
bind 平台账号绑定
可以通过bind接口使用户的平台账号和网站本身账号或者平台账号之间实现绑定。
unbind 平台账号解除绑定
可以通过unbind接口使用户的平台账号和网站本身账号或者平台账号之间解除绑定。
all_unbind 全部解除绑定
可以通过all_unbind接口使用户的所有账号绑定关系全部解除。
bind_info 获取绑定关系
可以通过bind_info接口获取到用户的所有平台账号绑定关系,即使此用户并没有在你的网站上进行过绑定。
好友类接口
friends 获取可邀请好友列表
可以通过friends接口获取用户绑定的平台账号上的所有未访问过你网站的好友信息。
recommend_user 获取站内好友列表
可以通过recommend_user接口获取用户绑定的平台账号上的所有已经访问过你网站的好友信息。
invite 发送好友邀请
可以通过invite接口向用户的好友发送邀请,根据不同平台发送的形式有所不同。
同步类接口
send_login_feed 发送登录新鲜事
可以通过send_login_feed接口在用户使用平台账号登录网站时,向该平台发送一条登录信息。
share 同步信息
用户可以通过share接口在用户发布帖子、日志、评论等信息时,把此信息同步到用户绑定的多个平台上。
其他类接口
get_media 获取已选择平台供应商
用户可以通过get_media接口获取已经选择的所有平台供应商