API文档
(→私信接口) |
|||
(未显示9个用户的145个中间版本) | |||
第1行: | 第1行: | ||
+ | <p class="tips_txt"><font style="color:red">重要:</font>新创建应用需要通过审核必须使用OAuth2.0和新版接口。 [[V1_To_V2|新版接口迁移指南]] | ||
+ | [[API文档_V2|新版接口文档]] [[授权机制说明|OAuth2.0开发指南]]</p> | ||
+ | |||
+ | <div style="display:none;"> | ||
+ | |||
== 微博基础数据接口 (Rest API) == | == 微博基础数据接口 (Rest API) == | ||
=== 获取下行数据集(timeline)接口 === | === 获取下行数据集(timeline)接口 === | ||
− | *[[statuses/public_timeline]] | + | *[[statuses/public_timeline]] 获取最新的公共微博消息 |
− | *[[statuses/friends_timeline]] | + | *[[statuses/friends_timeline]] 获取当前登录用户及其所关注用户的最新微博消息 (别名: statuses/home_timeline) |
− | *[[statuses/user_timeline]] | + | *[[statuses/user_timeline]] 获取用户发布的微博消息列表 |
*[[statuses/mentions]] 获取@当前用户的微博列表 | *[[statuses/mentions]] 获取@当前用户的微博列表 | ||
*[[statuses/comments_timeline]] 获取当前用户发送及收到的评论列表 | *[[statuses/comments_timeline]] 获取当前用户发送及收到的评论列表 | ||
*[[statuses/comments_by_me]] 获取当前用户发出的评论 | *[[statuses/comments_by_me]] 获取当前用户发出的评论 | ||
*[[statuses/comments_to_me]] 获取当前用户收到的评论 | *[[statuses/comments_to_me]] 获取当前用户收到的评论 | ||
− | *[[statuses/comments]] | + | *[[statuses/comments]] 根据微博消息ID返回某条微博消息的评论列表 |
*[[statuses/counts]] 批量获取一组微博的评论数及转发数 | *[[statuses/counts]] 批量获取一组微博的评论数及转发数 | ||
+ | *[[statuses/repost_timeline]] 返回一条原创微博的最新n条转发微博信息 <span style="color:red;">New!</span> | ||
+ | *[[statuses/repost_by_me]] 返回用户转发的最新n条微博信息 <span style="color:red;">New!</span> | ||
*[[statuses/unread]] 获取当前用户未读消息数 | *[[statuses/unread]] 获取当前用户未读消息数 | ||
− | *[[statuses/reset_count]] | + | *[[statuses/reset_count]] 未读消息数清零接口 |
+ | *[[emotions]] 表情接口,获取表情列表 | ||
=== 微博访问接口 === | === 微博访问接口 === | ||
*[[statuses/show]] 根据ID获取单条微博信息内容 | *[[statuses/show]] 根据ID获取单条微博信息内容 | ||
*[[user/statuses/id]] 根据微博ID和用户ID跳转到单条微博页面 | *[[user/statuses/id]] 根据微博ID和用户ID跳转到单条微博页面 | ||
− | *[[statuses/update]] 发布一条微博信息 | + | *[[statuses/update]] 发布一条微博信息<span style="color:red">Updated!</span> |
*[[statuses/upload]] 上传图片并发布一条微博信息 | *[[statuses/upload]] 上传图片并发布一条微博信息 | ||
*[[statuses/destroy]] 删除一条微博信息 | *[[statuses/destroy]] 删除一条微博信息 | ||
− | *[[statuses/repost]] | + | *[[statuses/repost]] 转发一条微博信息<span style="color:red">Updated!</span> |
− | *[[statuses/comment]] 对一条微博信息进行评论 | + | *[[statuses/comment]] 对一条微博信息进行评论<span style="color:red">Updated!</span> |
− | *[[statuses/comment_destroy]] 删除当前用户的微博评论信息 | + | *[[statuses/comment_destroy|statuses/comment_destroy/:id]] 删除当前用户的微博评论信息 |
− | *[[statuses/reply]] 回复微博评论信息 | + | *[[statuses/comment/destroy_batch]] 批量删除当前用户的微博评论信息 |
+ | *[[statuses/reply]] 回复微博评论信息<span style="color:red">Updated!</span> | ||
=== 用户接口 === | === 用户接口 === | ||
*[[users/show]] 根据用户ID获取用户资料(授权用户) | *[[users/show]] 根据用户ID获取用户资料(授权用户) | ||
− | *[[statuses/friends]] | + | <div style="display:none;">*[[user/friends/update_define]] 修改用户关注对象的备注信息</div> |
− | *[[statuses/followers]] | + | *[[statuses/friends]] 获取用户关注列表及每个关注用户最新一条微博 |
+ | *[[statuses/followers]] 获取用户粉丝列表及及每个粉丝用户最新一条微博 | ||
+ | *[[users/hot]] 获取系统推荐用户 | ||
+ | *[[user/friends/update_remark]]更新当前登录用户所关注的某个好友的备注信息<span style="color:red">New!</span> | ||
+ | *[[users/suggestions]] 返回当前用户可能感兴趣的用户 <span style="color:red">Beta!</span> | ||
+ | |||
+ | <div style="display:none;"> | ||
+ | |||
+ | 私信接口 <span style="color:red">高级</span> | ||
+ | 私信接口默认为限制接口 | ||
+ | |||
− | |||
*[[direct_messages]] 获取当前用户最新私信列表 | *[[direct_messages]] 获取当前用户最新私信列表 | ||
*[[direct_messages/sent]] 获取当前用户发送的最新私信列表 | *[[direct_messages/sent]] 获取当前用户发送的最新私信列表 | ||
*[[direct_messages/new]] 发送一条私信 | *[[direct_messages/new]] 发送一条私信 | ||
− | *[[direct_messages/destroy]] 删除一条私信 | + | *[[direct_messages/destroy|direct_messages/destroy/:id]] 删除一条私信 |
*[[direct_messages/destroy_batch]] 批量删除私信 | *[[direct_messages/destroy_batch]] 批量删除私信 | ||
+ | </div> | ||
=== 关注接口 === | === 关注接口 === | ||
第41行: | 第60行: | ||
*[[friendships/exists]] 是否关注某用户(推荐使用friendships/show) | *[[friendships/exists]] 是否关注某用户(推荐使用friendships/show) | ||
*[[friendships/show]] 获取两个用户关系的详细情况 | *[[friendships/show]] 获取两个用户关系的详细情况 | ||
+ | |||
+ | ===话题接口<span style="color:red">Beta!</span>=== | ||
+ | *[[trends]] 获取某人的话题 | ||
+ | *[[trends/statuses]] 获取某一话题下的微博 | ||
+ | *[[trends/follow]] 关注某一个话题 | ||
+ | *[[trends/destroy]] 取消关注的某一个话题 | ||
+ | *[[trends/hourly]] 按小时返回热门话题 | ||
+ | *[[trends/daily]] 返回当日热门话题。 | ||
+ | *[[trends/weekly]] 返回当周热门话题。 | ||
=== Social Graph接口=== | === Social Graph接口=== | ||
*[[friends/ids ]] 获取用户关注对象uid列表 | *[[friends/ids ]] 获取用户关注对象uid列表 | ||
*[[followers/ids ]] 获取用户粉丝对象uid列表 | *[[followers/ids ]] 获取用户粉丝对象uid列表 | ||
+ | ===隐私设置接口<span style="color:red; font-size:12px;">[NEW]</span>=== | ||
+ | *[[account/update_privacy]] 设置隐私信息 | ||
+ | *[[account/get_privacy]] 获取隐私信息 | ||
+ | |||
+ | ===黑名单接口 <span style="color:red; font-size:12px;">[NEW]</span>=== | ||
+ | *[[blocks/create]] 将某用户加入黑名单 | ||
+ | *[[blocks/destroy]] 将某用户移出黑名单 | ||
+ | *[[blocks/exists]] 检测某用户是否是黑名单用户 | ||
+ | *[[blocks/blocking]] 列出黑名单用户(输出用户详细信息) | ||
+ | *[[blocks/blocking/ids]] 列出分页黑名单用户(只输出id) | ||
+ | |||
+ | ===用户标签接口<span style="color:red; font-size:12px;">[NEW]</span>=== | ||
+ | *[[tags]] 返回指定用户的标签列表 | ||
+ | *[[tags/create]] 添加用户标签 | ||
+ | *[[tags/suggestions]] 返回用户感兴趣的标签 | ||
+ | *[[tags/destroy]] 删除标签 | ||
+ | *[[tags/destroy_batch]] 批量删除标签 | ||
=== 账号接口 === | === 账号接口 === | ||
第52行: | 第97行: | ||
*[[account/update_profile_image]] 更改头像 | *[[account/update_profile_image]] 更改头像 | ||
*[[account/update_profile]] 更改资料 | *[[account/update_profile]] 更改资料 | ||
− | |||
− | |||
=== 收藏接口 === | === 收藏接口 === | ||
第61行: | 第104行: | ||
*[[favorites/destroy_batch]] 批量删除收藏的微博信息 | *[[favorites/destroy_batch]] 批量删除收藏的微博信息 | ||
− | === | + | === 短链接口 <span style="color:red; font-size:12px;">[NEW]</span>=== |
− | *[[ | + | *[[short_url/shorten ]] 将一个或多个长链接转换成短链接 |
+ | *[[short_url/expand]] 将一个或多个短链接还原成原始的长链接 | ||
+ | *[[short_url/share/counts]] 取得一个短链接在微博上的微博分享数(包含原创和转发的微博) | ||
+ | *[[short_url/share/statuses]] 取得包含指定单个短链接的最新微博内容 | ||
+ | *[[short_url/comment/counts ]] 取得一个短链接在微博上的微博评论数 | ||
+ | *[[short_url/comment/comments]] 取得包含指定单个短链接的最新微博评论内容 | ||
=== 登录/OAuth接口 === | === 登录/OAuth接口 === | ||
第69行: | 第117行: | ||
*[[oauth/authorize]] 请求用户授权Token | *[[oauth/authorize]] 请求用户授权Token | ||
*[[oauth/access_token]] 获取授权过的Access Token | *[[oauth/access_token]] 获取授权过的Access Token | ||
+ | <span style="display:none"> *[[xAuth]] xAuth授权方式介绍 </span> | ||
+ | === 登录/OAuth 2.0接口=== | ||
+ | *[[OAuth2/access_token]] 获取授权过的Access Token | ||
+ | *[[Oauth2/authorize]] 请求用户授权Token | ||
− | = | + | <div style="display:none;"> |
− | + | 微博搜索 API <span style="color:red">高级</span> | |
− | + | 搜索接口默认为限制接口 | |
− | *[[users/search]] 搜索微博用户 (仅对新浪合作开发者开放) | + | |
− | + | 用户搜索 | |
+ | *[[users/search]] 搜索微博用户 (仅对新浪合作开发者开放) <span style="color:red"> Updated!</span> | ||
+ | *[[search/suggestions/at_users]] 在@某人时,实时获取用户名建议。亦可作关注人/粉丝搜索。(对所有开发者开放)<span style="color:red">New!</span> | ||
+ | |||
+ | 微博搜索 | ||
*[[search]] 搜索微博文章 (仅对新浪合作开发者开放) | *[[search]] 搜索微博文章 (仅对新浪合作开发者开放) | ||
*[[statuses/search]] 搜索微博(多条件组合) (仅对合作开发者开放) | *[[statuses/search]] 搜索微博(多条件组合) (仅对合作开发者开放) | ||
+ | </div> | ||
+ | |||
+ | ==微博地理位置信息接口== | ||
+ | 有任何问题,请联系 @[http://weibo.com/sinamap 新浪地图] | ||
+ | |||
+ | ===地图引擎接口<span style="color:red; font-size:12px;">[NEW]</span>=== | ||
+ | *[[Map-JS]] 是一套由JS语言编写的地图引擎,您可以用它在网站中构建功能丰富、交互性强的地图应用 | ||
+ | |||
+ | ===POI数据搜索接口<span style="color:red; font-size:12px;">[NEW]</span>=== | ||
+ | *[[pois/keyword]] 根据关键字和(或)分类进行搜索,返回相关的poi点信息 | ||
+ | *[[pois/round]] 根据关键字和(或)分类,在中心点附近搜索,返回相关的poi点信息 | ||
+ | *[[pois/view]] 根据关键字和(或)分类,在一个矩形里进行搜索,返回相关的poi点信息 | ||
+ | |||
+ | ===POI数据处理接口<span style="color:red; font-size:12px;">[NEW]</span>=== | ||
+ | *[[pois/add_poi]] 新增POI数据 | ||
+ | *[[pois/get_poi]] 获取新增POI数据 | ||
+ | |||
+ | ===移动定位接口<span style="color:red; font-size:12px;">[NEW]</span>=== | ||
+ | *[[loc/get_location]] 根据基站、WIFI等其它数据,返回当前位置 | ||
+ | |||
+ | ===地址转换接口<span style="color:red; font-size:12px;">[NEW]</span>=== | ||
+ | *[[geocode/ip_to_geo]] 根据ip返回地理信息 | ||
+ | *[[geocode/address_to_geo]] 根据地址返回坐标的接口 | ||
+ | *[[geocode/geo_to_address]] 根据坐标返回地址信息 | ||
+ | |||
+ | ===驾车路线搜索接口<span style="color:red; font-size:12px;">[NEW]</span>=== | ||
+ | *[[navigation/route]] 驾车路线查询 | ||
+ | |||
+ | ===公交搜索接口<span style="color:red; font-size:12px;">[NEW]</span>=== | ||
+ | *[[bus/transfer]] 根据起始id或坐标搜索公交换乘路线 | ||
+ | *[[bus/line]] 线路名称搜索 | ||
+ | *[[bus/station]] 公交站点名称搜索 | ||
+ | |||
+ | ===空间计算接口<span style="color:red; font-size:12px;">[NEW]</span>=== | ||
+ | *[[distance/distance_point]] 计算地图上两点之间的距离 | ||
+ | *[[distance/distance_po_li]] 计算地图上(x,y)到线的最近距离 | ||
+ | *[[distance/distance_line]] 计算地图上线的长度 | ||
+ | |||
+ | ===静态地图接口<span style="color:red; font-size:12px;">[NEW]</span>=== | ||
+ | *[[base/get_map_image]]生成一个静态地图的图片 | ||
− | == | + | ===地理位置信息接口错误代码及解释=== |
− | + | *[[location/error]] 地理位置信息接口错误代码及解释 | |
− | == | + | |
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | *[[ | + | |
== 测试接口 == | == 测试接口 == | ||
− | *[[ | + | *[[help/test]] 测试接口 |
== 附录 == | == 附录 == | ||
第98行: | 第187行: | ||
*[[direct_message]] 私信信息 | *[[direct_message]] 私信信息 | ||
*[[省份城市编码表]] | *[[省份城市编码表]] | ||
+ | *[[Metadata]] 元数据<span style="color:red;"> New!</span> | ||
+ | |||
=== 地理信息字段说明 === | === 地理信息字段说明 === | ||
− | *[[ | + | *[[location/citycode]] 城市代码对应表 |
− | *[[ | + | *[[location/citycode_bus]] 公交城市代码表 |
− | *[[ | + | *[[location/category]] 分类代码对应表 |
+ | |||
+ | </div> | ||
+ | |||
+ | __NOTOC__ |
2017年2月21日 (二) 12:16的最后版本
重要:新创建应用需要通过审核必须使用OAuth2.0和新版接口。 新版接口迁移指南 新版接口文档 OAuth2.0开发指南
文档更新时间: 2017-02-21