y
o
2
lua.com
app engine
alpha
登录
注册
开发文档
开发者社区
基础应用
如何工作
首页
开发文档 / 网易微博API文档
Hello yo2lua App Engine ;)
首页
LUA 语言介绍
SDK 开发包
创建一个应用
基础应用
网易微博API文档
腾讯微博API文档
Web 开发框架
内容导航:
==环境配置== 请先在基础应用页面(http://yo2lua.com/add-ons/)添加网易微博应用,并在你的 /config.lua 中加入网易微博开放平台的key和secret 如: [lua[ weibo.netease.key = '******' weibo.netease.secret ='************' ]] 接下去就可以在你的应用环境中使用下列函数方法使用网易微博 如: [lua[ dump(weibo.netease.statuses.public_timeline()) ]] ==微博列表== weibo.netease.statuses.home_timeline(Count, Since_id, Max_id, Trim_user) ====获取当前登录用户的微博列表==== 参数: Count 可选,默认30条,最大为200条 Since_id 可选,该参数需传cursor_id,返回此条索引之前发的微博列表,不包含此条 Max_id:可选参数,该参数需传cursor_id,返回此条索引之后发的微博列表,不包含此条; Trim_user:可选参数,值为true时返回的user对象只包含id属性,该属性能在一定程度上减少返回的数据量 * cursor_id,在读取一次列表后,可在列表数据中获取 * 如要忽略某个参数,如 Since_id 请把该值定为 nil 如:home_timeline(2, nil, '-6644025187269591679:1306423317304') weibo.netease.statuses.public_timeline(Trim_user) ====获取最新的公共微博列表(随便看看)==== 返回最新20条 参数: Trim_user:可选参数,值为true时返回的user对象只包含id属性,该属性能在一定程度上减少返回的数据量 weibo.netease.statuses.mentions(Count, Since_id, Max_id, Trim_user) ====获取@评论当前登录用户的微博列表==== 参数: Count 可选,默认30条,最大为200条 Since_id 可选,该参数需传cursor_id,返回此条索引之前发的微博列表,不包含此条 Max_id:可选参数,该参数需传cursor_id,返回此条索引之后发的微博列表,不包含此条; Trim_user:可选参数,值为true时返回的user对象只包含id属性,该属性能在一定程度上减少返回的数据量 weibo.netease.statuses.user_timeline_by_user_id(User_id, Count, Since_id, Max_id, Trim_user) ====获取指定用户的微博列表==== 参数: User_id 必选,用户ID,主要是用来区分用户ID跟微博昵称相同产生歧义的情况。 Count 可选,默认30条,最大为200条 Since_id 可选,该参数需传cursor_id,返回此条索引之前发的微博列表,不包含此条 Max_id:可选参数,该参数需传cursor_id,返回此条索引之后发的微博列表,不包含此条; Trim_user:可选参数,值为true时返回的user对象只包含id属性,该属性能在一定程度上减少返回的数据量 weibo.netease.statuses.user_timeline_by_screen_name(Screen_name, Count, Since_id, Max_id, Trim_user) ====获取指定用户的微博列表==== 参数: Screen_name 必选,可以传user_id或screen_name Count 可选,默认30条,最大为200条 Since_id 可选,该参数需传cursor_id,返回此条索引之前发的微博列表,不包含此条 Max_id:可选参数,该参数需传cursor_id,返回此条索引之后发的微博列表,不包含此条; Trim_user:可选参数,值为true时返回的user对象只包含id属性,该属性能在一定程度上减少返回的数据量 weibo.netease.statuses.user_timeline_by_name(Name, Count, Since_id, Max_id, Trim_user) ====获取指定用户的微博列表==== 参数: Name 必选,用户昵称 Count 可选,默认30条,最大为200条 Since_id 可选,该参数需传cursor_id,返回此条索引之前发的微博列表,不包含此条 Max_id:可选参数,该参数需传cursor_id,返回此条索引之后发的微博列表,不包含此条; Trim_user:可选参数,值为true时返回的user对象只包含id属性,该属性能在一定程度上减少返回的数据量 weibo.netease.statuses.retweets_of_me(Count, Since_id) ====获取当前登录用户所发微博被转发的列表==== 参数: Count 可选,默认30条,最大为200条 Since_id 可选,该参数需传cursor_id,返回此条索引之前发的微博列表,不包含此条 weibo.netease.statuses.comments_by_me(Count, Since_id, Max_id, Trim_user) ====获取当前登录用户发出的评论列表==== 参数: Count 可选,默认30条,最大为200条 Since_id 可选,该参数需传cursor_id,返回此条索引之前发的微博列表,不包含此条 Max_id:可选参数,该参数需传cursor_id,返回此条索引之后发的微博列表,不包含此条; Trim_user:可选参数,值为true时返回的user对象只包含id属性,该属性能在一定程度上减少返回的数据量 weibo.netease.statuses.comments_to_me(Count, Since_id, Max_id, Trim_user) ====获取当前登录用户收到的评论列表==== 参数: Count 可选,默认30条,最大为200条 Since_id 可选,该参数需传cursor_id,返回此条索引之前发的微博列表,不包含此条 Max_id:可选参数,该参数需传cursor_id,返回此条索引之后发的微博列表,不包含此条; Trim_user:可选参数,值为true时返回的user对象只包含id属性,该属性能在一定程度上减少返回的数据量 ==微博== weibo.netease.statuses.update(Status,[pic={filename, content_type, data},] Lat, Long, Vid) ====发布一条微博==== 微博内容过长则返回403状态; 发布失败则返回500状态。 参数: Status,必选参数,微博内容,不得超过163个字符; pic,可选参数,数据格式:table,如:{filename='a.jpg', content_type='image/jpg', data='@@JPG@@二进制文件内容'} Lat:可选参数,即纬度。范围在+90.0 到 -90.0,如果超出这个范围则忽略该值,必须与long参数一起使用,否则忽略该值。只有当用户的geo_enable为true时才有效; Long:可选参数,即经度。范围在+180.0到-180.0,如果超出这个范围则忽略该值,必须与lat参数一起使用,否则忽略该值。只有当用户的geo_enable为true时才有效; Vid:可选参数,即 POI 的 ID,某一个具体的地点,比如天安门。 weibo.netease.statuses.upload(Fname, Ftype, Data) ====上传图片文件并返回图片地址==== 将获得的图片地址通过发微博(statuses/update)接口附在微博正文里一同发出,则得到一个包含图片的微博。 如果未使用oauth认证返回401; 图片超过大小限制或格式不正确则返回403; 参数: Fname,必选参数,图片文件名 Ftype,必须参数,图片格式,如:image/jpeg Data,必须参数,图片二进制数据 weibo.netease.statuses.reply(Id, Status, Is_retweet, Is_comment_to_root) ====评论一条微博==== 参数: Id:必选参数,值为被评论微博的ID。如果回复某条评论,则此值为该评论的id。 Status :必选参数,评论内容。 Is_retweet:可选参数,是否转发 默认不转发 1为转发 Is_comment_to_root:是否评论给原微博 默认不评论 1为评论 weibo.netease.statuses.retweet(Id, Status, Is_comment, Is_comment_to_root) ====转发一条微博==== 参数: Id:必选参数,值为被评论微博的ID。如果回复某条评论,则此值为该评论的id。 Status :必选参数,评论内容。 Is_comment:可选参数,是否转发 默认不转发 1为转发 Is_comment_to_root:是否评论给原微博 默认不评论 1为评论 weibo.netease.statuses.show(Id) ====获取单条微博信息==== 如果根据id没有找到对应微博则返回404状态。 参数: Id:必选参数,值为被转发微博的ID。 weibo.netease.statuses.destroy(Id) ====删除指定的微博==== 也可以撤销已转发的微博 参数: Id:必选参数,值为删除或撤销转发微博的ID。 weibo.netease.statuses.comments(Id, Count, Since_id, Max_id, Trim_user) ====查看指定微博的所有评论==== 返回的数据与WEB的单条微博页的评论列表数据一致 如果未使用oauth认证返回401; 找不到微博返回404 参数: Id:必选参数,指定的微博id; Count:可选参数,数量,默认为30条,最大为200条; Since_id:可选参数,该参数需传微博id,返回此条索引之后发的微博列表,不包含此条; Max_id:可选参数,该参数需传微博id,返回此条微博之前发的微博列表,包含此条; Trim_user:可选参数,值为true时返回的user对象只包含id属性,该参数能在一定程度上减少返回的数据量。 weibo.netease.statuses.retweets(Id, Count, Since_id, Max_id, Trim_user) ====查看指定微博的所有转发信息==== 返回的数据与WEB上单条微博页的转发数据一致 如果未使用oauth认证返回401; 找不到微博返回404 参数: Id:必选参数,指定的微博id; Count:可选参数,数量,默认为30条,最大为200条; Since_id:可选参数,该参数需传微博id,返回此条索引之后发的微博列表,不包含此条; Max_id:可选参数,该参数需传微博id,返回此条微博之前发的微博列表,包含此条; Trim_user:可选参数,值为true时返回的user对象只包含id属性,该参数能在一定程度上减少返回的数据量。 weibo.netease.statuses.retweeted_by(Id, Count) ====获取一条微博被转发的用户信息==== 根据id没有找到对应微博则返回404状态。 参数: Id:必选参数,指定的微博id; Count:可选参数,数量,默认为100条,最大为100条; ==用户== weibo.netease.users.show_by_screen_name(Screen_name) ====获取指定用户信息==== 如果用户通行证身份验证成功且用户已经开通微博则返回http状态为200; 如果不是则返回401的状态和错误信; 根据参数查找不到对应的用户则返回404的状态和错误信息。 参数: Screen_name,必选参数,用户的个性网址 weibo.netease.users.show_by_name(Name) ====获取指定用户信息==== 如果用户通行证身份验证成功且用户已经开通微博则返回http状态为200; 如果不是则返回401的状态和错误信; 根据参数查找不到对应的用户则返回404的状态和错误信息。 参数: Name,必选参数,用户的昵称 weibo.netease.users.show_by_user_id(User_id) ====获取指定用户信息==== 如果用户通行证身份验证成功且用户已经开通微博则返回http状态为200; 如果不是则返回401的状态和错误信; 根据参数查找不到对应的用户则返回404的状态和错误信息。 参数: Name,必选参数,用户ID weibo.netease.users.suggestions(Count, Trim_user) ====返回用户可能感兴趣的用户==== 随机返回指定数目的用户 如果未登录返回401,找不到任何推荐用户返回404。 参数: Count:可选参数,指定随机返回的用户数目。默认为30个,最多返回30个; Trim_user:可选参数,值为true时返回的user对象只包含id属性,该参数能在一定程度上减少返回的数据量。 weibo.netease.users.suggestions_i_followers(Cursor, Trim_user) ====获取推荐的I达人的用户列表==== 参数: Cursor:可选参数,分页参数 Trim_user:可选参数,值为true时返回的user对象只包含id属性,该参数能在一定程度上减少返回的数据量。 ==关系== weibo.netease.friendships.create(Screen_name) ====关注指定用户==== 如果用户通行证身份验证成功且用户已经开通微博则返回http状态为200; 如果不是则返回401的状态和错误信息; 根据参数查找不到对应的用户则返回404的状态和错误信息。 参数: Screen_name:必选参数,该用户的个性网址,也可以传user_id; weibo.netease.friendships.destroy(Screen_name) ====取消关注指定用户==== 如果用户通行证身份验证成功且用户已经开通微博则返回http状态为200; 如果不是则返回401的状态和错误信息; 根据参数查找不到对应的用户则返回404的状态和错误信息。 参数: Screen_name:必选参数,该用户的个性网址,也可以传user_id; weibo.netease.friendships.show(Source_id, Source_screen_name, Target_id, Target_screen_name) ====获取两个用户的相互关注关系==== 如果用户通行证身份验证成功且用户已经开通微博则返回http状态为200; 如果不是则返回401的状态和错误信息; 根据参数查找不到对应的用户则返回404的状态和错误信息。 参数: Source_id:可选参数,指定用户的userId Source_screen_name:可选参数,指定用户的个性网址 Target_id:可选参数,指定用户的userId Target_screen_name:可选参数,目标用户的个性网址 其中: source_id和source_screen_name均未传时使用当前登录用户作为source用户 target_id或target_screen_name必须传递一个 weibo.netease.statuses.friends(Screen_name, Cursor) ====获取指定用户的关注用户列表==== 如果用户通行证身份验证成功且用户已经开通微博则返回http状态为200; 如果不是则返回401的状态和错误信; 根据参数查找不到对应的用户则返回404的状态和错误信息。 参数: Screen_name:可选参数,该用户的个性网址,也可以传user_id; Cursor:可选参数,分页参数,单页只能包含30个关注列表 weibo.netease.statuses.followers(Screen_name, Cursor) ====获取指定被关注用户列表==== 如果用户通行证身份验证成功且用户已经开通微博则返回http状态为200; 如果不是则返回401的状态和错误信; 根据参数查找不到对应的用户则返回404的状态和错误信息。 参数: Screen_name:可选参数,该用户的个性网址,也可以传user_id; Cursor:可选参数,分页参数,单页只能包含30个关注列表 weibo.netease.friends.names() ====获取当前用户的关注人名字列表==== 可用于@提示功能 ==热榜== weibo.netease.statuses.topRetweets(Type, Size) ====获取当前的热门转发榜==== 如果用户通行证身份验证成功且用户已经开通微博则返回http状态为200; 如果不是则返回401的状态和错误信息。 type非法或者其对应的排行榜无数据则发挥404的状态。 参数: Type:必选参数,排行榜类型,当前有4种:oneHour,sixHours,oneDay,oneWeek Size:可选参数,返回数量,不传则为默认值(当前为50),最多50 ==话题== weibo.netease.trends.recommended() ====推荐话题API==== 其效果与“我的首页”右侧的推荐话题一致 没有任何推荐话题返回404; 推荐话题为专题时返回url,为话题时返回query。 ==私信== weibo.netease.direct_messages.get(Count, Since_id) ====获取当前用户私信列表==== 如果用户通行证身份验证成功且用户已经开通微博则返回http状态为200; 如果不是则返回401的状态和错误信息; 根据参数查找不到对应的用户则返回404的状态和错误信息。 参数: Since_id:可选参数,上一页最后一条私信的id。 Count:可选参数,获取私信的数量。 weibo.netease.direct_messages.send(Count, Since_id) ====获取当前用户发送的私信列表==== 如果用户通行证身份验证成功且用户已经开通微博则返回http状态为200; 如果不是则返回401的状态和错误信息; 根据参数查找不到对应的用户则返回404的状态和错误信息。 参数: Since_id:可选参数,上一页最后一条私信的id。 Count:可选参数,获取私信的数量。 weibo.netease.direct_messages.new(User, Text) ====发送一条私信==== 如果用户通行证身份验证成功且用户已经开通微博则返回http状态为200; 如果不是则返回401的状态和错误信息; 根据参数查找不到对应的用户则返回404的状态和错误信息。 text参数为空或超过163字符或收信用户没有关注当前用户或用户发给本人则返回403的状态和错误信息。 参数: User:必选参数,收信用户的昵称,即name; Text:必选参数,私信内容。 weibo.netease.direct_messages.destroy(Id) ====删除一条私信==== 如果用户通行证身份验证成功且用户已经开通微博则返回http状态为200; 如果不是则返回401的状态和错误信息; 根据id参数查找不到对应的私信则返回404的状态和错误信息。 参数: Id:必选参数,删除的私信id ==账号== weibo.netease.account.verify_credentials() ====判断当前用户是否验证成功并返回该用户信息==== 如果用户通行证身份验证成功且用户已经开通微博则返回http状态为200; 如果不是则返回401的状态和错误信息; 此方法用了判断用户身份是否合法且已经开通微博。 weibo.netease.account.rate_limit_status() ====返回当前小时内剩余访问次数==== weibo.netease.reminds.message.latest() ====返回当前登录用户未读的新消息数量==== 如果用户通行证身份验证成功且用户已经开通微博则返回http状态为200; 如果不是则返回401的状态和错误信息。 ==收藏== weibo.netease.favorites.get(Id, Count, Since_id) ====获取指定用户的收藏==== 如果用户通行证身份验证成功且用户已经开通微博则返回http状态为200; 根据参数没有找到对应用户则返回404。 参数: Id:必选参数,可以为该用户的个性网址(screen_name); Uount:返回微博数量,默认30,最大200 Since_id:分页参数,传cursor_id,返回此条微博以前发的微博列表,不包含此条 weibo.netease.favorites.create(Id) ====添加收藏==== 如果用户通行证身份验证成功且用户已经开通微博则返回http状态为200; 根据参数没有找到对应用户则返回404。 参数: Id:必选参数,要收藏的微博ID。 weibo.netease.favorites.destroy(Id) ====删除收藏==== 如果用户通行证身份验证成功且用户已经开通微博则返回http状态为200; 根据参数没有找到对应用户则返回404。 参数: Id:必选参数,要删除收藏的微博ID。 ==黑名单== weibo.netease.blocks.create(Screen_name) ====阻止指定用户==== 即将该用户添加进黑名单 如果用户通行证身份验证成功且用户已经开通微博则返回http状态为200; 如果不是则返回401的状态和错误信息。 根据参数查找不到对应的用户则返回404的状态和错误信息。 参数: Screen_name:必选参数,该用户的个性网址,也可以传user_id; weibo.netease.blocks.destroy(Screen_name) ====取消已阻止的用户==== 即将该用户添移除黑名单 如果用户通行证身份验证成功且用户已经开通微博则返回http状态为200; 如果不是则返回401的状态和错误信息。 根据参数查找不到对应的用户或不在黑名单中则返回404的状态和错误信息。 参数: Screen_name:必选参数,该用户的个性网址,也可以传user_id; weibo.netease.blocks.exists(Screen_name) ====判断是否已经阻止用户==== 如已阻止此用户则返回用户信息,如未阻止则返回状态404,同时提示“此用户未被加入黑名单” 如果用户通行证身份验证成功且用户已经开通微博则返回http状态为200; 如果不是则返回401的状态和错误信息。 根据参数查找不到对应的用户则返回404的状态和错误信息。 参数: Screen_name:必选参数,该用户的个性网址,也可以传user_id; weibo.netease.blocks.blocking() ====返回当前登录用户屏蔽的用户列表==== 如果用户通行证身份验证成功且用户已经开通微博则返回http状态为200; weibo.netease.blocks.blocking_ids() ====返回当前登录用户屏蔽的用户id数组==== 如果用户通行证身份验证成功且用户已经开通微博则返回http状态为200; ==搜索== weibo.netease.search(Q, Page, Per_page) ====搜索微博==== 未带q参数时会返回400状态 参数: Q:必选参数,关键字,最大长度25,如果以#起始的关键字会作为tag搜索精确匹配 Page:可选参数,当前页数,默认为第一页 Per_page:可选参数,返回数量,最大20 weibo.netease.statuses.search(Q, Page, Per_page, Trim_user) ====搜索微博==== 未带q参数时会返回400状态 参数: Q:必选参数,关键字,最大长度25,如果以#起始的关键字会作为tag搜索精确匹配 Page:可选参数,当前页数,默认为第一页 Per_page:可选参数,返回数量,最大20 Trim_user:可选参数,值为true时返回的user对象只包含id属性,该参数能在一定程度上减少返回的数据量。 weibo.netease.users.search(Q, Page, Per_page) ====搜索用户==== 未带q参数时会返回400状态 参数: Q:必选参数,关键字,最大长度25,如果以#起始的关键字会作为tag搜索精确匹配 Page:可选参数,当前页数,默认为第一页 Per_page:可选参数,返回数量,最大20条。
发布于:2011-06-02 13:03:03