API接口文档

2012年4月27日 (五) 10:30的版本

API通用说明

1. 云登入API

下面的几个部分详细描述了你需要向云登入的服务器发起的API调用接口。接下来的部分先讨论一般的请求(request)和回应(response)格式，以及针对每个API调用的报错情况。

1. 请求（request）格式

每个从云登入API调用都以一个对应下表中的基础URL的HTTP POST开始。而且，每个调用方法都附了一个名称，以及一组必填或选填的参数。

基础API的URL

http://denglu.ex-sandbox.com/api/

用户类接口

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接口获取已经选择的所有平台供应商