API

出自YiqiWiki

本文包含了一起网兼容FACEBOOK的相关API描述.你可以将SNS数据(如:利用profile,friend,group等数据)引入你开发的应用中,未来我们还将逐步加入新的数据支持.

REST 接口

API接口类似于REST.这意味着通过发送HTTP GET or POST给YIQI API REST server即可实现对这些方法的调用.几乎任何计算机语言都可以通过HTTP同REST server通讯.
请注意，下面每个方法都有可选的参数 format,callback,意义是：

callback参数：
   一旦设置了，意味着你是在AJAX中调用（所以一般不应该使用）并期望调用完成自动通知你。
  于是format忽略，返回内容自动变成javascript，并且返回时自动调用callback所指的函数；
format参数：
   本次调用返回时数据格式

你可以用一起网提供的PHP包调用这些API，不用PHP时请参看常见问题的说明。

API 方法

admin.getAppProperties (BETA)

返回来自一起网应用中,你的应用相关属性.

application.getPublicInfo

返回给定应用的公开信息.(注:不必是你安装的).

batch.run (BETA)

成批执行API调用序列.

fql.query

执行一条FQL查询.

friends.areFriends

返回给定用户ID对集合,用户ID对是否具有朋友关系.

friends.get

返回当前用户在一起网的好友ID列表.

friends.getAppUsers

返回当前用户一起网中的朋友ID(这些朋友已经授权给调用应用)

friends.getLists

返回当前用户在一起网的好友ID列表及名字.

groups.get

返回满足指定条件的群组信息.

groups.getMembers

返回指定群组成员并分类.

notifications.send

给指定用户集合发通知.

notifications.sendEmail

给指定用户集合发Email.

feed.publishActionOfUser

发送一条朋友Feed

feed.publishStoryToUser

发送一条个人Feed

users.getInfo

以数组形式返回给定用户并指定的相关信息.

users.getLoggedInUser

得到当前SESSION对应的用户ID.

users.hasAppPermission

检查用户是否选择了应用附加权限.

users.isAppAdded

新的profile设计推出给所有用户后,这种方法将废弃后.

users.isAppUser

返回用户(用户可以是当前或UID指定的用户)是否被授权访问调用该方法的应用.