核心方法
hello.api()
Post
发布一条状态消息
调用方法
hello.api("/me/share","post",[data]).then([callback]);
hello.api("/me/share","post",[data],[callback]);
[data]
{message:'',link:'',picture:''}
回调函数取得的[data]
{}
Post
发布一条状态消息并上传一个媒体文件
调用方法
hello.api("/me/share","post",[data]).then([callback]);
hello.api("/me/share","post",[data],[callback]);
[data]
{message:'',file:''}
回调函数取得的[data]
{}
Post
分享一条已有的消息
调用方法
hello.api("/me/share","post",[data]).then([callback]);
hello.api("/me/share","post",[data],[callback]);
[data]
{id:/^\S+$/}
回调函数取得的[data]
{}
Get
取得一个我点“赞”、点“妙”、加“星”过的内容列表
调用方法
hello.api("/me/like","get",[data]).then([callback]);
hello.api("/me/like","get",[data],[callback]);
[data]
{limit:/^\S+$/}
回调函数取得的[data]
{}
Post
对一些内容点“赞”,点“妙”、加“星”
调用方法
hello.api("/me/like","post",[data]).then([callback]);
hello.api("/me/like","post",[data],[callback]);
[data]
{id:/^\S+$/}
回调函数取得的[data]
{}
Delete
对一些内容弃“赞”、弃“妙”、去“星”
调用方法
hello.api("/me/like","delete",[data]).then([callback]);
hello.api("/me/like","delete",[data],[callback]);
[data]
{id:/^\S+$/}
回调函数取得的[data]
{}
Get
列出我的相册
调用方法
hello.api("/me/albums","get",[data]).then([callback]);
hello.api("/me/albums","get",[data],[callback]);
[data]
{limit:/\d+/}
回调函数取得的[data]
{id:/^\S+$/,name:/^[\w\d\s\.\-]+$/,thumbnail:/^https?\:\/\//,photos:/^\S+$/}
Get
列出我的某个相册中的图片
调用方法
hello.api("/me/album","get",[data]).then([callback]);
hello.api("/me/album","get",[data],[callback]);
[data]
{id:/\d+/}
回调函数取得的[data]
{id:/^\S+$/,name:/^[\w\d\s\.\-]+$/,picture:/^https?\:\/\//}
Get
列出我的所有的图片
调用方法
hello.api("/me/photos","get",[data]).then([callback]);
hello.api("/me/photos","get",[data],[callback]);
[data]
{limit:/\d+/}
回调函数取得的[data]
{id:/^\S+$/,name:/^[\w\d\s\.\-]+$/,picture:/^https?\:\/\//}
Get
列出我的某个一个ID的图片
调用方法
hello.api("/me/photo","get",[data]).then([callback]);
hello.api("/me/photo","get",[data],[callback]);
[data]
{id:/\d+/}
回调函数取得的[data]
{id:/^\S+$/,picture:/^https?\:\/\//}
Post
创建一个相册
调用方法
hello.api("/me/albums","post",[data]).then([callback]);
hello.api("/me/albums","post",[data],[callback]);
[data]
{name:"",description:""}
回调函数取得的[data]
{id:/^\s+$}
Delete
删除一个相册
调用方法
hello.api("/me/album","delete",[data]).then([callback]);
hello.api("/me/album","delete",[data],[callback]);
[data]
{id:/\d+/}
回调函数取得的[data]
{success:true}
Post
向相册中上传图片
调用方法
hello.api("/me/album","post",[data]).then([callback]);
hello.api("/me/album","post",[data],[callback]);
[data]
{id:/\d+,file:""/}
回调函数取得的[data]
{id:/^\s+$/}
Post
通过URL向相册添加图片
调用方法
hello.api("/me/album","post",[data]).then([callback]);
hello.api("/me/album","post",[data],[callback]);
[data]
{id:/^\s+$/,url:dataURL,name:""}
回调函数取得的[data]
{id:/^\S+$/}
Delete
从一个相册中删除一个图片
调用方法
hello.api("/me/photo","delete",[data]).then([callback]);
hello.api("/me/photo","delete",[data],[callback]);
[data]
{id:/^\s+$/}
回调函数取得的[data]
{success:true}
Get
列出我的文件
调用方法
hello.api("/me/files","get",[data]).then([callback]);
hello.api("/me/files","get",[data],[callback]);
[data]
{limit:/^\s+$/}
回调函数取得的[data]
{id:/^\S+$/,name:/^[\w\d\s\.\-]+$/,picture:/^https?\:\/\//,photos:/^\S+$/}
Get
列出文件夹
调用方法
hello.api("/me/folders","get",[data]).then([callback]);
hello.api("/me/folders","get",[data],[callback]);
[data]
{limit:/^\s+$/}
回调函数取得的[data]
{id:/^\S+$/,name:/^[\w\d\s\.\-]+$/}
Post
创建一个文件夹
调用方法
hello.api("/me/folders","post",[data]).then([callback]);
hello.api("/me/folders","post",[data],[callback]);
[data]
{name:""}
回调函数取得的[data]
{id:/^\S+$/,name:/^[\w\d\s\.\-]+$/}
Get
取得一个文件夹内容
调用方法
hello.api("/me/folder","get",[data]).then([callback]);
hello.api("/me/folder","get",[data],[callback]);
[data]
{id:/^\s+$/}
回调函数取得的[data]
{id:/^\S+$/,name:/^[\w\d\s\.\-]+$/}
Delete
删除一个文件夹
调用方法
hello.api("/me/folder","delete",[data]).then([callback]);
hello.api("/me/folder","delete",[data],[callback]);
[data]
{id:/^\s+$/}
回调函数取得的[data]
{success:true}
Get
取得一个文件夹中的所有文件
调用方法
hello.api("/me/files","get",[data]).then([callback]);
hello.api("/me/files","get",[data],[callback]);
[data]
{parent:/^\s+$/}
回调函数取得的[data]
{id:/^\S+$/,name:/^[\w\d\s\.\-]+$/}
Post
上传我的文件
调用方法
hello.api("/me/files","post",[data]).then([callback]);
hello.api("/me/files","post",[data],[callback]);
[data]
{parent:/^\s+$/,file:"",name:""}
回调函数取得的[data]
{id:/^\S+$/,name:/^[\w\d\s\.\-]+$/}
Post
把一个DataURL上传为文件
调用方法
hello.api("/me/files","post",[data]).then([callback]);
hello.api("/me/files","post",[data],[callback]);
[data]
{parent:/^\s+$/,file:dataURL,name:""}
回调函数取得的[data]
{id:/^\S+$/,name:/^[\w\d\s\.\-]+$/}
Put
更新文件内容
调用方法
hello.api("/me/files","put",[data]).then([callback]);
hello.api("/me/files","put",[data],[callback]);
[data]
{id:/^\s+$/,file:dataURL,name:""}
回调函数取得的[data]
{id:/^\S+$/,name:/^[\w\d\s\.\-]+$/}
Put
移动文件位置
调用方法
hello.api("/me/files","put",[data]).then([callback]);
hello.api("/me/files","put",[data],[callback]);
[data]
{id:/^\s+$/,parent:/^\s+$/}
回调函数取得的[data]
{id:/^\S+$/,name:/^[\w\d\s\.\-]+$/}
Delete
删除我的文件
调用方法
hello.api("/me/files","delete",[data]).then([callback]);
hello.api("/me/files","delete",[data],[callback]);
[data]
{id:/^\s+$/}
回调函数取得的[data]
{success:true}
示例
javascript
hello('facebook').api('me').then(function(json) { alert('Your name is ' + json.name); }, function(e) { alert('Whoops! ' + e.error.message); });
事件订阅
hello.on()
在一个事件上绑定一个回调函数。用户状态的变化或者某些详情的变化,都可以触发一个事件。
hello.on(event,callback);
事件 | 描述 |
---|---|
auth | 在会话发生变化时触发 |
auth.login | 在用户登录时触发 |
auth.logout | 在用户登出时触发 |
auth.update | 在用户证书变化时触发 |
示例
javascript
var sessionStart = function() { alert('Session has started'); }; hello.on('auth.login', sessionStart);
hello.off()
移除一个回调函数,事件名和函数都必须是已经存在的。
hello.off(event,callback)
示例
javascript
hello.off('auth.login',sessionStart);
**粗体** _斜体_ [链接](http://example.com) `代码` - 列表 > 引用
。你还可以使用@
来通知其他用户。