腾讯微博开放API文档.docx
《腾讯微博开放API文档.docx》由会员分享，可在线阅读，更多相关《腾讯微博开放API文档.docx（138页珍藏版）》请在冰豆网上搜索。
腾讯微博开放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,
Mcount:
2,
From:
"来自网页",
Id:
7987543214334,
Image:
["",""],
Name:
"abc",
Nick:
"abcd",
Uid:
"xxxxxxxxx",
Source:
{
text:
"",
Origtext:
"",
Count:
2,
Mcount:
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,
Mcount:
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
}
]
},
'User':
{
'name':
'nick',
'name':
'nick',
............
}
}
字段说明：
Ret:
0成功非0失败
Msg错误信息
Data：
Timestamp服务器时间戳，不能用于翻页
hasNext:
0表示还有微博可拉取1已拉取完毕
Info:
Text:
微博内容
Origtext:
原始内容
Count:
微博被转次数
Mcount:
点评次数
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
User:
Name:
nick当页数据涉及到的用户的帐号与昵称映射
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,
Mcount:
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,
Mcount:
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,
}
]
},
'User':
{
'name':
'nick',
'name':
'nick',
............
}
}
字段说明：
Ret:
0成功非0失败
Msg错误信息
Data：
Timestamp服务器时间戳
hasNext:
0表示还有微博可拉取1已拉取完毕
Info:
Text:
微博内容
Origtext:
原始内容
Count:
微博被转次数
Mcount:
点评次数
From:
来源
Id:
微博唯一ID
Image:
图片URL列表
Name:
发表人帐户名
Nick：
发表人昵称
Self:
是否自已发的的微博0：
不是1是
Timestamp:
发表时间
Type:
微博类型1-原创发表、2-转载、3-私信4-回复5-空回6-提及
Head:
发表者头像URL
Location:
发表者所在地
Isvip:
是否微博认证用户
Geo:
发表者地理信息
User:
Name:
nick当页数据涉及到的用户的帐号与昵称映射
3.Statuses/user_timeline其他用户发表时间线
URL
格式
xml,json
HTTP请求方式
GET
是否需要鉴权
true
请求数限制
true
关于请求数限制，参见接口访问权限说明
请求参数：
oauth标准参数，并带上以下参数
Format:
返回数据的格式是（json或xml）
Pageflag分页标识（0：
第一页，1：
向下翻页，2向上翻页）
PageTime:
本页起始时间（第第一页时填0，继续翻页：
填上一次请求返回的最后一条记录时间，
Reqnum:
每次请求记录的条数（1-20条）
Lastid:
第一页时填0,继续向下翻页，填上一次请求返回的最后一条记录ID，翻页用
Name:
你需要读取该用户的用户名
使用说明
返回结果
{
ret:
0,
Msg:
"ok",
Data:
{
Timestamp:
128679200,
hasNext:
0,
totalNum:
100,
Info:
[
{
text:
"",
Origtext:
"",
Count:
2,
Mcount:
2,
From:
"来自网页",
Id:
7987543214334,
Image:
["",""],
Name:
"abc",
Nick:
"abcd",
Uid:
"xxxxxxxxx",
Source:
{
text:
"",
Origtext:
"",
Count:
2,
Mcount:
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,
Mcount:
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
}
]
},
'User':
{
'name':
'nick',
'name':
'nick',
............
}
}
字段说明：
Ret:
0成功非0失败
Msg错误信息
Data：
Timestamp服务器时间戳
hasNext:
0表示还有微博可拉取1已拉取完毕
Totalnum:
所有记录的总数
Info:
Text:
微博内容
Origtext:
原始内容
Count:
微博被转次数
Mcount:
点评次数
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
User:
Name:
nick当页数据涉及到的用户的帐号与昵称映射
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,
Mcount:
2,
From:
"来自网页",
Id:
7987543214334,
Image:
["",""],
Name:
"abc",
Nick:
"abcd",
Uid:
"xxxxxxxxx",
Source:
{
text:
"",
Origtext:
"",
Count:
2,
Mcount:
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,
Mcount:
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
}
]
},
'User':
{
升级会员 