API文档
(→微博基础数据接口 (Rest API)) |
|||
| 第57行： | 第57行： | ||
===黑名单接口 <span style="color:red; font-size:12px;">[NEW]</span>=== | ===黑名单接口 <span style="color:red; font-size:12px;">[NEW]</span>=== | ||
*[[blocks/create]] 将某用户加入黑名单 | *[[blocks/create]] 将某用户加入黑名单 | ||
| − | *[[ | + | *[[blocks/destroy]] 将某用户移出黑名单 |
| − | *[[ | + | *[[blocks/exists]] 检测某用户是否是黑名单用户 |
| − | *[[ | + | *[[blocks/blocking]] 列出黑名单用户(输出用户详细信息) |
| − | *[[ | + | *[[blocks/blocking/ids]] 列出分页黑名单用户（只输出id） |
===用户标签接口<span style="color:red; font-size:12px;">[NEW]</span>=== | ===用户标签接口<span style="color:red; font-size:12px;">[NEW]</span>=== | ||
| − | *[[ | + | *[[tags]] 返回指定用户的标签列表 |
| − | *[[ | + | *[[tags/create]] 添加用户标签 |
| − | *[[ | + | *[[tags/suggestions]] 返回用户感兴趣的标签 |
| − | *[[ | + | *[[tags/destroy]] 删除标签 |
| − | *[[ | + | *[[tags/destroy_batch]] 批量删除标签 |
=== 账号接口 === | === 账号接口 === | ||
| 第76行： | 第76行： | ||
*[[account/update_profile]] 更改资料 | *[[account/update_profile]] 更改资料 | ||
*[[account/register]] 注册新浪微博帐号 | *[[account/register]] 注册新浪微博帐号 | ||
| − | *[[ | + | *[[account/activate]] 二次注册微博的接口 |
=== 收藏接口 === | === 收藏接口 === | ||
| 第101行： | 第101行： | ||
Map API仅对新浪合作开发者开放，有任何问题，请联系 @[http://t.sina.com.cn/mapapi 地理信息开放平台] | Map API仅对新浪合作开发者开放，有任何问题，请联系 @[http://t.sina.com.cn/mapapi 地理信息开放平台] | ||
=== 地理信息搜索接口 === | === 地理信息搜索接口 === | ||
| − | *[[ | + | *[[location/route]] 驾车路线搜索接口 |
| − | *[[ | + | *[[location/bus]] 公交换乘路线搜索接口 |
=== 坐标获取接口 === | === 坐标获取接口 === | ||
| − | *[[ | + | *[[location/ip2xy]] 获取ip对应坐标的接口 |
| − | *[[ | + | *[[location/addr2xy]] 获取地址对应坐标的接口 |
| − | *[[ | + | *[[location/get_addr]] 获取坐标的地址信息的接口 |
== 测试接口 == | == 测试接口 == | ||
| − | *[[ | + | *[[help/test]] 测试接口 |
== 附录 == | == 附录 == | ||
| 第119行： | 第119行： | ||
*[[省份城市编码表]] | *[[省份城市编码表]] | ||
=== 地理信息字段说明 === | === 地理信息字段说明 === | ||
| − | *[[ | + | *[[location/citycode]] 城市代码对应表 |
| − | *[[ | + | *[[location/citycode_bus]] 公交城市代码表 |
| − | *[[ | + | *[[location/category]] 分类代码对应表 |
2010年12月15日 (三) 14:50的版本
目录 |
微博基础数据接口 (Rest API)
获取下行数据集(timeline)接口
- statuses/public_timeline 获取最新的公共微博消息
- statuses/friends_timeline 获取当前登录用户及其所关注用户的最新微博消息 (别名: statuses/home_timeline)
- statuses/user_timeline 获取当前登录用户发布的微博消息列表
- statuses/mentions 获取@当前用户的微博列表
- statuses/comments_timeline 获取当前用户发送及收到的评论列表
- statuses/comments_by_me 获取当前用户发出的评论
- statuses/comments_to_me 获取当前用户收到的评论
- statuses/comments 根据微博消息ID返回某条微博消息的评论列表
- statuses/counts 批量获取一组微博的评论数及转发数
- statuses/repost_timeline 返回一条原创微博的最新n条转发微博信息 New!
- statuses/repost_by_me 返回用户转发的最新n条微博信息 New!
- statuses/unread 获取当前用户未读消息数
- statuses/reset_count 未读消息数清零接口
- emotions 表情接口，获取表情列表
微博访问接口
- statuses/show 根据ID获取单条微博信息内容
- user/statuses/id 根据微博ID和用户ID跳转到单条微博页面
- statuses/update 发布一条微博信息
- statuses/upload 上传图片并发布一条微博信息
- statuses/destroy 删除一条微博信息
- statuses/repost 转发一条微博信息
- statuses/comment 对一条微博信息进行评论
- statuses/comment_destroy/:id 删除当前用户的微博评论信息
- statuses/comment/destroy_batch 批量删除当前用户的微博评论信息
- statuses/reply 回复微博评论信息
用户接口
- users/show 根据用户ID获取用户资料（授权用户）
- statuses/friends 获取用户关注列表及每个关注用户最新一条微博
- statuses/followers 获取用户粉丝列表及及每个粉丝用户最新一条微博
- users/hot 获取系统推荐用户
私信接口
- direct_messages 获取当前用户最新私信列表
- direct_messages/sent 获取当前用户发送的最新私信列表
- direct_messages/new 发送一条私信
- direct_messages/destroy/:id 删除一条私信
- direct_messages/destroy_batch 批量删除私信
关注接口
- friendships/create 关注某用户
- friendships/destroy 取消关注
- friendships/exists 是否关注某用户(推荐使用friendships/show)
- friendships/show 获取两个用户关系的详细情况
Social Graph接口
- friends/ids 获取用户关注对象uid列表
- followers/ids 获取用户粉丝对象uid列表
隐私设置接口[NEW]
- account/update_privacy 设置隐私信息
- account/get_privacy 获取隐私信息
黑名单接口 [NEW]
- blocks/create 将某用户加入黑名单
- blocks/destroy 将某用户移出黑名单
- blocks/exists 检测某用户是否是黑名单用户
- blocks/blocking 列出黑名单用户(输出用户详细信息)
- blocks/blocking/ids 列出分页黑名单用户（只输出id）
用户标签接口[NEW]
- tags 返回指定用户的标签列表
- tags/create 添加用户标签
- tags/suggestions 返回用户感兴趣的标签
- tags/destroy 删除标签
- tags/destroy_batch 批量删除标签
账号接口
- account/verify_credentials 验证当前用户身份是否合法
- account/rate_limit_status 获取当前用户API访问频率限制
- account/end_session 当前用户退出登录
- account/update_profile_image 更改头像
- account/update_profile 更改资料
- account/register 注册新浪微博帐号
- account/activate 二次注册微博的接口
收藏接口
- favorites 获取当前用户的收藏列表
- favorites/create 添加收藏
- favorites/destroy 删除当前用户收藏的微博信息
- favorites/destroy_batch 批量删除收藏的微博信息
登录/OAuth接口
- oauth OAuth授权方式介绍
- oauth/request_token 获取未授权的Request Token
- oauth/authorize 请求用户授权Token
- oauth/access_token 获取授权过的Access Token
微博搜索 API (Search API)
Search API仅对新浪合作开发者开放，申请请联系 @微博开放平台
用户搜索
- users/search 搜索微博用户 (仅对新浪合作开发者开放)
微博搜索
- search 搜索微博文章 (仅对新浪合作开发者开放)
- statuses/search 搜索微博(多条件组合) (仅对合作开发者开放)
微博地理位置信息API (Location API)
Map API仅对新浪合作开发者开放，有任何问题，请联系 @地理信息开放平台
地理信息搜索接口
- location/route 驾车路线搜索接口
- location/bus 公交换乘路线搜索接口
坐标获取接口
- location/ip2xy 获取ip对应坐标的接口
- location/addr2xy 获取地址对应坐标的接口
- location/get_addr 获取坐标的地址信息的接口
测试接口
- help/test 测试接口
附录
Rest API字段说明
- status 微博信息内容
- user 用户资料信息
- comment 评论信息描述
- direct_message 私信信息
- 省份城市编码表
地理信息字段说明
- location/citycode 城市代码对应表
- location/citycode_bus 公交城市代码表
- location/category 分类代码对应表
