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