使用新浪微博开放平台api同步微博内容至自己网站(使用微博API的简便方法,你已经有了吗?)
优采云 发布时间: 2021-11-15 19:05使用新浪微博开放平台api同步微博内容至自己网站(使用微博API的简便方法,你已经有了吗?)
Twitter API 将为每个请求返回适当的 HTTP 状态。例如,当请求一个不存在的用户信息时,API 将返回 404 Not Found;当请求未通过身份验证和授权时,API 将返回 401 Not Authorized 状态。
使用 API 的简单方法
如果您的系统上安装了 curl,那么您已经拥有了一个非常强大的使用微博 API 的工具。下面是一个使用curl的例子,很简单:
未经授权访问public_timeline:curl
获取好友的时间线,使用身份验证:curl -u email:password
仅获取标题信息: curl --head email:password
用户状态相关方法
状态/public_timeline
返回未设置隐私的用户的最后 20 条消息(必须具有自定义用户头像)。这种方法不需要身份认证。
地址:
支持格式(format):xml、json、rss、atom
参数列表:
没有。
状态/朋友_时间线
返回最近 24 小时内经过身份验证的用户及其好友的最新 20 条更新消息。
地址:
支持格式(format):xml、json、rss、atom
参数列表:
since_id:可选参数(微博信息ID)。仅返回ID大于since_id(晚于since_id)的微博信息内容。
例子:
max_id:可选参数(微博信息ID)。返回ID不大于max_id的微博信息内容。
例子:
计数:可选参数。每次返回的最大记录数,不能超过200条,默认为20.
例子:
页面:可选参数。返回结果的页码。注意:有分页限制。根据用户关注的帖子数,通常最多返回1000条最新的微博分页内容,默认为1条
例子:
状态/用户时间线
返回最近 24 小时内由经过身份验证的用户更新的最新 20 条消息。同样,给定的 userIdOrName 参数可用于请求其他用户的最新消息更新。API 可能未经过身份验证。
地址:
支持的格式(format):xml、json、rss、atom
参数列表:
id:可选参数。根据指定的用户UID或微博昵称返回微博信息。
例子:
user_id:可选参数。用户UID主要用于区分用户UID和微博昵称。有歧义时,尤其是微博昵称是数字时,与用户Uid有歧义。
例子:
screen_name:可选参数。微博昵称,主要用于在出现歧义时区分用户UID和微博昵称。
例子:
since_id:可选参数(微博信息ID)。只返回id大于since_id(晚于since_id)的微博信息内容
例子:
max_id:可选参数(微博信息ID)。返回ID不大于max_id的微博信息内容。
示例: 示例:
计数:可选参数。每次返回的最大记录数,最多返回200条记录,默认为20条。
例子:
页面:可选参数。分页返回。注意:返回最多 200 页的内容。
例子:
状态/提及
显示最近给用户的20条回复消息(消息前缀为@username)。此 API 仅对经过身份验证的用户开放。无论其他用户是否设置了隐私,向其他用户索取收到的回复信息列表都是非法的。
地址:
支持格式(format):xml、json、rss、atom
参数列表:
因为_id。可选参数。返回 ID 大于值 since_id(晚于 since_id)的提及项。
例子:
最大 ID。可选参数。返回 ID 不大于 max_id(时间不晚于 max_id)的提及。
例子:
数数。可选参数。每次返回的最大记录数(即页面大小),不大于200条,默认为20条。
例子:
页。可选参数。返回结果的页码。注意:有分页限制。
例子:
用户留言相关方法
状态/显示
返回指定Id的消息,返回的消息收录作者信息。
访问地址:或
{ID}
支持格式(format):xml、json
参数列表:
ID。必选参数(微博信息ID),获取发布的微博ID,如果ID不存在,返回空
例子:
状态/更新
更新已验证用户的消息必须收录 content 参数,并且必须在 POST 模式下请求。成功后,以指定格式返回当前消息。
地址:
支持的格式(format):xml、json
参数列表:
地位。必填参数,待更新微博信息。必须完成 URLEncode。信息内容超过140个汉字。如果为空,将返回 400 错误。
in_reply_to_status_id。可选参数,要回复的微博消息的@ID。此参数仅在微博内容以@username 开头时才有意义。
纬度 可选参数,纬度,当前微博发布的地理位置,有效范围-90.0到+90.0,+表示北纬。地理位置只有在用户设置中 geo_enabled=true 时才有效。
长。可选参数,经度。有效范围为 -180.0 到 +180.0,+ 表示东经。
状态/破坏
要根据指定的 id 删除消息,经过身份验证的用户必须是消息的作者。
地址:
支持格式(format):xml、json
参数列表:
id 必须是要删除的消息的 id,例如:
或者
用户界面
用户/节目
显示指定用户的扩展信息,需要指定用户的id或显示名。扩展信息包括用户的页面设置、微博数量等,第三方应用的开发者可以根据这些信息为用户提供合适的话题。
注意:此API调用请求必须由合法微博用户发出,无论是向自己或他人请求扩展信息。
地址:
支持的格式(format):xml、json
参数列表:
ID。用户 UID 或微博昵称。
示例:或
用户身份。指定用户UID,主要用于区分用户UID和微博昵称。当存在歧义时,尤其是用户账号为数字时,与用户Uid存在歧义。
例子:
屏幕名称。指定微博昵称,主要用于在出现歧义时区分用户UID和微博昵称。
例子:
状态/朋友
返回认证用户的好友列表,其中收录每个用户当前的微博信息。这个方法也可以用来请求其他用户的好友列表,通过下面指定的方法传递id参数。
地址:
支持的格式(format):xml、json
参数列表:
ID。可选参数。获取UID或微博昵称
例子:
用户身份。可选参数。需要获取的UID
例子:
屏幕名称。可选参数。微博昵称待获取
例子:
光标。可选参数。单个页面只能收录 100 个监视列表。为了得到更多,游标默认从-1开始。您可以通过增加或减少光标来获得更多。如果没有下一页,next_cursor 返回 0
'S观察名单
例子:
例子:
数数。可选参数。每次返回的最大记录数(即页面大小),不大于200条,默认返回20条。
例子:
状态/追随者
返回经过身份验证的用户的订阅者,收录每个订阅者的当前消息。就像好友一样,只需将好友地址中的好友替换为关注者即可,其他所有参数,包括参数,都不需要更改。他们都是一样的。
地址:
支持的格式(format):xml、json
参数列表:
ID。可选参数。获取粉丝的UID或微博昵称
示例:或
用户身份。可选参数。需要获取的UID
例子:
屏幕名称。可选参数。微博昵称待获取
例子:
光标。可选参数。一个页面只能收录 100 个粉丝列表。为了得到更多,游标默认从-1开始。您可以通过增加或减少光标来获得更多。如果没有下一页,next_cursor 返回 0
粉丝列表示例: 示例:
数数。可选参数。每次返回的最大记录数(即页面大小),不大于200条,默认返回20条。
例子:
私信操作方法
direct_messages
返回用户的消息列表
地址:
支持格式(format):xml、json、rss、atom
参数列表:
因为_id。可选参数。返回id大于since_id值(晚于since_id)的私信。
例子:
最大 ID。可选参数。返回ID不大于max_id(时间不晚于max_id)的私信。
例子:
数数。可选参数。每次返回的最大记录数(即页面大小),不大于200。
例子:
页。可选参数。返回结果的页码。注意:有分页限制。
例子:
直接消息/发送
返回用户的已发消息列表
地址:
支持格式(format):xml、json、rss、atom
参数列表:
因为_id。可选参数。返回id大于since_id值(晚于since_id)的私信。
例子:
最大 ID。可选参数。返回ID不大于max_id(时间不晚于max_id)的私信。
例子:
数数。可选参数。每次返回的最大记录数(即页面大小),不大于200。
例子:
页。可选参数。返回结果的页码。注意:有分页限制。
direct_messages/新
作为认证用户,向指定的其他用户发送定向消息,必须收录参数 user 和 text,并且请求必须使用 POST 提交。成功将返回完整的发送消息,必须收录参数 user 和 text,并且必须使用 POST 提交。成功将返回完整的发送消息。
地址:
支持格式(format):xml、json
参数列表:
用户:user_id 或 screen_name
文本:必需参数。生成的消息内容需要URLEncode,文字大小必须小于300个汉字
direct_messages/销毁
使用给定的消息 id,删除指定的定向消息,经过身份验证的用户只能删除作为收件人收到的消息。POST 和 GET 方法都可以使用
地址:
支持格式(format):xml、json
参数列表:
ID。必选参数,需要删除的私信主键ID。
例子:
友情操作方法
友谊/创造
在经过身份验证的用户和给定 id 参数指定的用户之间创建好友关系;如果操作执行成功,将返回已添加为好友的用户信息,如果执行失败,将返回失败状态字符串。
地址:
支持格式(format):xml、json
参数列表:
以下参数必须具有其中之一:
ID。必需参数。要关注的用户 UID 或微博昵称
示例:或
用户身份。必需参数。关注用户的UID主要用于区分用户UID和微博昵称,造成歧义。
例子:
屏幕名称。必需参数。关注的微博昵称主要用于区分用户UID和微博昵称,造成歧义。
例子:
跟随。可选参数。目前不支持。
友谊/破坏
用于取消指定id的用户的好友关系。操作成功时,返回取消好友关系的用户,失败时返回失败信息。
地址:
支持格式(format):xml、json
参数列表:
以下参数必须具有其中之一:
ID。必需参数。要取消关注的用户 UID 或微博昵称
示例:或
用户身份。必需参数。取消关注用户的UID主要用于区分用户UID和微博昵称,造成歧义。
例子:
屏幕名称。必需参数。取消的微博昵称主要用于区分用户UID和微博昵称,造成歧义。
例子:
友谊/存在
用于检查两个用户之间的关系是朋友关系还是关注关系。返回彼此跟随的关系的结果。例如:A跟B,B不跟A,会返回对应的格式数据:如xml,true或false
地址:
支持格式:xml、json
参数列表:
用户_a。必选参数,需要判断的用户UID
用户_b。必选参数,需要判断的关注用户的UID
友谊/表演
返回两个用户之间关系的详细信息
地址:
支持格式:xml、json
参数列表:
以下参数可以留空,留空则取当前用户
源 ID。源用户 UID
例子:
源屏幕名称。来源微博昵称
例子:
以下参数必须是可选的:
目标 ID。待判断的目标用户的UID
例子:
目标屏幕名称。目标微博昵称待评
例子:
获取用户列表方法
朋友/ID
用于获取指定用户的好友用户id。即你关注的人的id
地址:
支持格式:xml、json
参数列表:
ID。可选参数。获取好友的UID或微博昵称
示例:或
用户身份。可选参数。需要获取的UID
例子:
屏幕名称。可选参数。微博昵称待获取
例子:
光标。可选参数。单个页面只能收录 5000 个 ID。为了得到更多,游标默认从-1开始。您可以通过增加或减少光标来获取更多观察列表。
示例: 示例:
数数。可选参数。每次返回的最大记录数(即页面大小),不大于5000条,默认返回500条。
例子:
关注者/ID
用于获取指定用户被关注的用户id。
地址:
支持格式:xml、json
参数列表:
ID。可选参数。获取好友的UID或微博昵称
示例:或
用户身份。可选参数,要获取的UID
例子:
屏幕名称。可选参数,要获取的微博昵称
例子:
光标。可选参数。单个页面只能收录 5000 个 ID。为了得到更多,游标默认从-1开始。您可以通过增加或减少光标来获取更多观察列表。
例子:
例子:
数数。可选参数。每次返回的最大记录数(即页面大小),不大于5000条,默认返回500条。
例子:
用户账号方式
帐户/verify_credentials
如果用户认证成功,则http状态为200;如果没有,将返回 401 状态和错误消息。该方法用于判断用户的身份是否合法。
地址:
支持格式:xml、json
参数列表:
帐户/update_profile
自定义微博页面参数。只会修改参数更新项。
地址:
支持格式:xml、json
参数列表:
以下参数必须有一个或多个,且参数值为字符串。进一步的限制,请参考下面各参数的说明。
姓名。昵称,可选参数。不超过20个汉字
性别 性别,可选参数。男,女,女。
省 可选参数。参考省市代码表
city 是一个可选参数。参考省市代码表,1000不限
描述。可选参数。不超过160个汉字。