新浪微博 SDK API文档

API文档

重要：新创建应用需要通过审核必须使用OAuth2.0和新版接口。
新版接口迁移指南新版接口文档

OAuth2.0开发指南

微博基础数据接口 (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 发布一条微博信息Updated!
statuses/upload 上传图片并发布一条微博信息
statuses/destroy 删除一条微博信息
statuses/repost 转发一条微博信息Updated!
statuses/comment 对一条微博信息进行评论Updated!
statuses/comment_destroy/:id 删除当前用户的微博评论信息
statuses/comment/destroy_batch 批量删除当前用户的微博评论信息
statuses/reply 回复微博评论信息Updated!

用户接口

users/show 根据用户ID获取用户资料（授权用户）
statuses/friends 获取用户关注列表及每个关注用户最新一条微博
statuses/followers 获取用户粉丝列表及及每个粉丝用户最新一条微博
users/hot 获取系统推荐用户
user/friends/update_remark更新当前登录用户所关注的某个好友的备注信息New!
users/suggestions 返回当前用户可能感兴趣的用户
Beta!

关注接口

friendships/create 关注某用户
friendships/destroy 取消关注
friendships/exists 是否关注某用户(推荐使用friendships/show)
friendships/show 获取两个用户关系的详细情况

话题接口Beta!

trends 获取某人的话题
trends/statuses 获取某一话题下的微博
trends/follow 关注某一个话题
trends/destroy 取消关注的某一个话题
trends/hourly 按小时返回热门话题
trends/daily 返回当日热门话题。
trends/weekly 返回当周热门话题。

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 更改资料

收藏接口

favorites 获取当前用户的收藏列表
favorites/create 添加收藏
favorites/destroy 删除当前用户收藏的微博信息
favorites/destroy_batch 批量删除收藏的微博信息

短链接口
[NEW]

short_url/shorten
将一个或多个长链接转换成短链接
short_url/expand 将一个或多个短链接还原成原始的长链接
short_url/share/counts 取得一个短链接在微博上的微博分享数（包含原创和转发的微博）
short_url/share/statuses 取得包含指定单个短链接的最新微博内容
short_url/comment/counts
取得一个短链接在微博上的微博评论数
short_url/comment/comments 取得包含指定单个短链接的最新微博评论内容

登录/OAuth接口

oauth OAuth授权方式介绍
oauth/request_token 获取未授权的Request Token
oauth/authorize 请求用户授权Token
oauth/access_token 获取授权过的Access Token

登录/OAuth 2.0接口

OAuth2/access_token 获取授权过的Access Token
Oauth2/authorize 请求用户授权Token

微博地理位置信息接口

有任何问题，请联系 @新浪地图

地图引擎接口[NEW]

Map-JS 是一套由JS语言编写的地图引擎，您可以用它在网站中构建功能丰富、交互性强的地图应用

POI数据搜索接口[NEW]

pois/keyword 根据关键字和（或）分类进行搜索，返回相关的poi点信息
pois/round 根据关键字和（或）分类，在中心点附近搜索，返回相关的poi点信息
pois/view 根据关键字和（或）分类，在一个矩形里进行搜索，返回相关的poi点信息

POI数据处理接口[NEW]

pois/add_poi 新增POI数据
pois/get_poi 获取新增POI数据

移动定位接口[NEW]

loc/get_location 根据基站、WIFI等其它数据，返回当前位置

地址转换接口[NEW]

geocode/ip_to_geo 根据ip返回地理信息
geocode/address_to_geo 根据地址返回坐标的接口
geocode/geo_to_address 根据坐标返回地址信息

驾车路线搜索接口[NEW]

navigation/route 驾车路线查询

公交搜索接口[NEW]

bus/transfer 根据起始id或坐标搜索公交换乘路线
bus/line 线路名称搜索
bus/station 公交站点名称搜索

空间计算接口[NEW]

distance/distance_point 计算地图上两点之间的距离
distance/distance_po_li 计算地图上（x，y）到线的最近距离
distance/distance_line 计算地图上线的长度

静态地图接口[NEW]

base/get_map_image生成一个静态地图的图片

地理位置信息接口错误代码及解释

location/error 地理位置信息接口错误代码及解释

测试接口

help/test 测试接口

附录

Rest API字段说明

status 微博信息内容
user 用户资料信息
comment 评论信息描述
direct_message 私信信息
省份城市编码表
Metadata 元数据 New!

地理信息字段说明

location/citycode 城市代码对应表
location/citycode_bus 公交城市代码表
location/category 分类代码对应表