腾讯微博开放API文档.docx
- 文档编号:23469881
- 上传时间:2023-05-17
- 格式:DOCX
- 页数:133
- 大小:33.41KB
腾讯微博开放API文档.docx
《腾讯微博开放API文档.docx》由会员分享,可在线阅读,更多相关《腾讯微博开放API文档.docx(133页珍藏版)》请在冰豆网上搜索。
腾讯微博开放API文档
腾讯微博开放API协议格式
时间:
2010-12-28
Starjiang
注意:
文档中所有参数请在使用时小写
Oauth授权
Oauth授权简介,请先熟悉OAUTH协议,这个去GOOGLE一下吧,你会找到很多
1.request_token
URL
格式
xml,json
HTTPS请求方式
GET
是否需要鉴权
true
请求数限制
true
关于请求数限制,参见接口访问权限说明
请求参数
oauth_callback:
回调URL
oauth_consumer_key:
你申请的appkey
oauth_nonce:
随机串(32个字符长度)
oauth_signature:
oauth请求签名
oauth_signature_method:
签名方法(HMAC-SHA1)
oauth_timestamp:
时间戳
oauth_version:
oauth版本号填(1.0)
使用说明
返回串:
oauth_token=a63f4a0e1242462fb8c11e53159ba294&oauth_token_secret=40ece707e064128e4fec692e3c09c692&oauth_callback_confirmed=true
Oauth_token:
返回的request_token
oauth_token_secret:
返回的request_secret
oauth_callback_confirmed:
回调确认
2.用户授权request_token
授权后,回调URL
3.交换access_token
URL
格式
xml,json
HTTPS请求方式
GET
是否需要鉴权
true
请求数限制
true
关于请求数限制,参见接口访问权限说明
请求参数
oauth_callback:
回调URL
oauth_consumer_key:
你申请的appkey
oauth_nonce:
随机串(32个字符长度)
oauth_signature:
oauth请求签名
oauth_signature_method:
签名方法(HMAC-SHA1)
oauth_timestamp:
时间戳
Oauth_token:
request_token
oauth_version:
oauth版本号填(1.0)
oauth_verifier:
验证码
使用说明
返回:
oauth_token=ffc37464473e48a2b22226350dc98210&oauth_token_secret=3fe92ec42e936672ceca549d432c237d&name=starjiang
oauth_token:
access_token
oauth_token_secret:
access_secret
Name:
微博帐户名
API请求示例说明
注:
所有API调用带上oauth的标准参数,及附加参数,oauth标准参数作认证鉴权用,附加参数:
即api请求参数(不同API有不同的附加参数),例:
oauth标准参数说明
oauth_consumer_key:
你申请的appkey
oauth_nonce:
随机串(32个字符长度)
oauth_signature:
oauth请求签名
oauth_signature_method:
签名方法(HMAC-SHA1)
oauth_timestamp:
时间戳
Oauth_token:
access_token
oauth_version:
oauth版本号填(1.0)
符加参数
Format
pageflag
reqnum
pagetime
时间线
1.Statuses/home_timeline主页时间线
URL
格式
xml,json
HTTP请求方式
GET
是否需要鉴权
true
请求数限制
true
关于请求数限制,参见接口访问权限说明
请求参数:
oauth标准参数,并带上以下参数
Format:
返回数据的格式是(json或xml)
Pageflag分页标识(0:
第一页,1:
向下翻页,2向上翻页)
PageTime:
本页起始时间(第一页时填0,继续翻页:
填上一次请求返回的最后一条记录时间,)
Reqnum:
每次请求记录的条数(1-20条)
使用说明
返回结果
{
ret:
0,
Msg:
"ok",
Data:
{
Timestamp:
128679200,//此字段为服务器当前时间,不能用于翻页
hasNext:
0,
Info:
[
{
text:
"",
Origtext:
"",
Count:
2,
From:
"来自网页",
Id:
7987543214334,
Image:
["",""],
Name:
"abc",
Nick:
"abcd",
Uid:
"xxxxxxxxx",
Source:
{
text:
"",
Origtext:
"",
Count:
2,
From:
"来自网页",
Id:
7987543214334,
Image:
null,
Name:
"abc",
Nick:
"abcd",
Uid:
"xxxxxxxxx",
Self:
0
Timestamp:
1285813236,
Type:
1,
Head:
"",
Location:
"广东深圳",
Country_code:
1,
Province_code:
44,
City_code:
3,
isVip:
0,
Geo:
null,
Status:
0
},
Self:
0
Timestamp:
1285813236,
Type:
2,//表示转播
Head:
"",
Location:
"广东深圳".
Country_code:
1,
Province_code:
44,
City_code:
3,
isVip:
0
Geo:
null,
Status:
0
},
{
text:
"",
Origtext:
"",
Count:
2,
From:
"来自网页",
Id:
7987543214334,
Image:
null,
Name:
"abc",
Nick:
"abcd",
Uid:
"xxxxxxxxx",
Self:
0
Timestamp:
1285813236,
Type:
1,
Head:
"",
Location:
"广东深圳",
Country_code:
1,
Province_code:
44,
City_code:
3,
isVip:
0
Geo:
null,
Status:
0
}
]
}
}
字段说明:
Ret:
0成功非0失败
Msg错误信息
Data:
Timestamp服务器时间戳,不能用于翻页
hasNext:
0表示还有微博可拉取1已拉取完毕
Info:
Text:
微博内容
Origtext:
原始内容
Count:
微博被转次数
From:
来源
Id:
微博唯一ID
Image:
图片URL列表
Name:
发表人帐户名
Nick:
发表人昵称
Self:
是否自已发的的微博0:
不是1是
Timestamp:
发表时间
Type:
微博类型1-原创发表、2-转载、3-私信4-回复5-空回6-提及
Head:
发表者头像URL
Location:
发表者所在地
Country_code:
国家码(其他时间线一样)
Province_code:
省份码(其他时间线一样)
City_code:
城市码(其他时间线一样)
Isvip:
是否微博认证用户
Geo:
发表者地理信息
Status:
微博状态0-正常,1-系统删除2-审核中3-用户删除4-根删除
Source:
当Type=2时,source即为源TWEET
2.Statuses/public_timeline广播大厅时间线
URL
格式
xml,json
HTTP请求方式
GET
是否需要鉴权
true
请求数限制
true
关于请求数限制,参见接口访问权限说明
请求参数:
oauth标准参数,并带上以下参数
Format:
返回数据的格式是(json或xml)
Pos:
记录的起始位置(第一次请求是填0,继续请求进填上次返回的Pos)
Reqnum:
每次请求记录的条数(1-20条)
使用说明
返回结果
{
ret:
0,
Msg:
"ok",
Data:
{
Pos:
20,
Timestamp:
128679200,
hasNext:
0,
Info:
[
{
text:
"",
Origtext:
"",
Count:
2,
From:
"来自网页",
Id:
7987543214334,
Image:
["",""],
Name:
"abc",
Nick:
"abcd",
Uid:
"xxxxxxxxx",
Self:
0
Timestamp:
1285813236,
Type:
1,
Head:
"",
Location:
"广东深圳",
Country_code:
1,
Province_code:
44,
City_code:
3,
isVip:
0,
Geo:
null,
Status:
0,
},
{
text:
"",
Origtext:
"",
Count:
2,
From:
"来自网页",
Id:
7987543214334,
Image:
["",""],
Name:
"abc",
Nick:
"abcd",
Uid:
"xxxxxxxxx",
Self:
0
Timestamp:
1285813236,
Type:
1,
Head:
"",
Location:
"广东深圳",
Country_code:
1,
Province_code:
44,
City_code:
3,
isVip:
0,
Geo:
null,
}
]
}
}
字段说明:
Ret:
0成功非0失败
Msg错误信息
Data:
Timestamp服务器时间戳
hasNext:
0表示还有微博可拉取1已拉取完毕
Info:
Text:
微博内容
Origtext:
原始内容
Count:
微博被转次数
From:
来源
Id:
微博唯一ID
Image:
图片URL列表
Name:
发表人帐户名
Nick:
发表人昵称
Self:
是否自已发的的微博0:
不是1是
Timestamp:
发表时间
Type:
微博类型1-原创发表、2-转载、3-私信4-回复5-空回6-提及
Head:
发表者头像URL
Location:
发表者所在地
Isvip:
是否微博认证用户
Geo:
发表者地理信息
3.Statuses/user_timeline其他用户发表时间线
URL
格式
xml,json
HTTP请求方式
GET
是否需要鉴权
true
请求数限制
true
关于请求数限制,参见接口访问权限说明
请求参数:
oauth标准参数,并带上以下参数
Format:
返回数据的格式是(json或xml)
Pageflag分页标识(0:
第一页,1:
向下翻页,2向上翻页)
PageTime:
本页起始时间(第第一页时填0,继续翻页:
填上一次请求返回的最后一条记录时间,
Reqnum:
每次请求记录的条数(1-20条)
Name:
你需要读取该用户的用户名
使用说明
返回结果
{
ret:
0,
Msg:
"ok",
Data:
{
Timestamp:
128679200,
hasNext:
0,
totalNum:
100,
Info:
[
{
text:
"",
Origtext:
"",
Count:
2,
From:
"来自网页",
Id:
7987543214334,
Image:
["",""],
Name:
"abc",
Nick:
"abcd",
Uid:
"xxxxxxxxx",
Source:
{
text:
"",
Origtext:
"",
Count:
2,
From:
"来自网页",
Id:
7987543214334,
Image:
null,
Name:
"abc",
Nick:
"abcd",
Uid:
"xxxxxxxxx",
Self:
0
Timestamp:
1285813236,
Type:
1,
Head:
"",
Location:
"广东深圳",
Country_code:
1,
Province_code:
44,
City_code:
3,
isVip:
0
Geo:
null,
Status:
0
},
Self:
0
Timestamp:
1285813236,
Type:
2,//表示转播
Head:
"",
Location:
"广东深圳"
isVip:
0
Geo:
null,
Status:
0
},
{
text:
"",
Origtext:
"",
Count:
2,
From:
"来自网页",
Id:
7987543214334,
Image:
null,
Name:
"abc",
Nick:
"abcd",
Uid:
"xxxxxxxxx",
Self:
0
Timestamp:
1285813236,
Type:
1,
Head:
"",
Location:
"广东深圳"
isVip:
0
Geo:
null,
Status:
0
}
]
}
}
字段说明:
Ret:
0成功非0失败
Msg错误信息
Data:
Timestamp服务器时间戳
hasNext:
0表示还有微博可拉取1已拉取完毕
Totalnum:
所有记录的总数
Info:
Text:
微博内容
Origtext:
原始内容
Count:
微博被转次数
From:
来源
Id:
微博唯一ID
Image:
图片URL列表
Name:
发表人帐户名
Nick:
发表人昵称
Self:
是否自已发的的微博0:
不是1是
Timestamp:
发表时间
Type:
微博类型1-原创发表、2-转载、3-私信4-回复5-空回6-提及
Head:
发表者头像URL
Location:
发表者所在地
Isvip:
是否微博认证用户
Geo:
发表者地理信息
Source:
当Type=2时,source即为源TWEET
4.Statuses/mentions_timeline用户提及时间线
URL
格式
xml,json
HTTP请求方式
GET
是否需要鉴权
true
请求数限制
true
关于请求数限制,参见接口访问权限说明
请求参数:
oauth标准参数,并带上以下参数
Format:
返回数据的格式是(json或xml)
Pageflag分页标识(0:
第一页,1:
向下翻页,2向上翻页)
PageTime:
本页起始时间(第一页时填0,继续向下翻页:
填上一次请求返回的最后一条记录时间)
Reqnum:
每次请求记录的条数(1-20条)
Lastid:
第一页时填0,继续向下翻页,填上一次请求返回的最后一条记录ID,翻页用
使用说明
返回结果
{
ret:
0,
Msg:
"ok",
Data:
{
Timestamp:
128679200,
hasNext:
0,
totalNum:
100,
Info:
[
{
text:
"",
Origtext:
"",
Count:
2,
From:
"来自网页",
Id:
7987543214334,
Image:
["",""],
Name:
"abc",
Nick:
"abcd",
Uid:
"xxxxxxxxx",
Source:
{
text:
"",
Origtext:
"",
Count:
2,
From:
"来自网页",
Id:
7987543214334,
Image:
null,
Name:
"abc",
Nick:
"abcd",
Uid:
"xxxxxxxxx",
Self:
0
Timestamp:
1285813236,
Type:
1,
Head:
"",
Location:
"广东深圳",
Country_code:
1,
Province_code:
44,
City_code:
3,
isVip:
0
Geo:
null,
Status:
0
},
Self:
0
Timestamp:
1285813236,
Type:
2,//表示转播
Head:
"",
Location:
"广东深圳"
isVip:
0
Geo:
null,
Status:
0
},
{
text:
"",
Origtext:
"",
Count:
2,
From:
"来自网页",
Id:
7987543214334,
Image:
null,
Name:
"abc",
Nick:
"abcd",
Uid:
"xxxxxxxxx",
Self:
0
Timestamp:
1285813236,
Type:
1,
Head:
"",
Location:
"广东深圳",
Country_code:
1,
Province_code:
44,
City_code:
3,
isVip:
0
Geo:
null,
Status:
0
}
]
}
}
字段说明:
Ret:
0成功非0失败
Msg错误信息
Data:
Timestamp服务器时间戳
hasNext:
0表示还有微博可拉取1已拉取完毕
Totalnum:
记录总数
Info:
Text:
微博内容
Origtext:
原始内容
Count:
微博被转次数
From:
来源
Id:
微博唯一ID
Image:
图片URL列表
Name:
发表人帐户名
Nick:
发表人昵称
Self:
是否自已发的的微博0:
不是1是
Timestamp:
发表时间
Type:
微博类型1-原创发表、2-转载、3-私信4-回复5-空回6-提及
Head:
发表者头像URL
Location:
发表者所在地
Isvip:
是否微博认证用户
Geo:
发表者地理信息
Source:
当Type=2时,source即为源TWEET
5.Statuses/ht_timeline话题时间线
URL
格式
xml,json
HTTP请求方式
GET
是否需要鉴权
true
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- 腾讯 开放 API 文档