为什么80%的码农都做不了架构师？>>>

一、授权认证

1、请求用户授权Token

URL： /oauth2/authorize

HTTP请求方式:GET/POST

请求参数

必选 类型及范围 说明

client_id true string 申请应用时分配的AppKey。

redirect_uri true string 授权回调地址，站外应用需与设置的回调地址一致，站内应用需填写canvas page的地址。

返回值字段 字段类型 字段说明

code string 用于调用access_token，接口获取授权后的access token。

state string 如果传递参数，会回传该参数。

示例

//请求

/oauth2/authorize?client_id=123050457758183&redirect_uri=/response&response_type=code

//同意授权后会重定向

/response&code=CODE

2、获取授权过的Access Token

URL ：/oauth2/access_token

HTTP请求方式 ：POST

请求参数

必选 类型及范围 说明

client_id true string 申请应用时分配的AppKey。

client_secret true string 申请应用时分配的AppSecret。

grant_type true string 请求的类型，填写authorization_code

grant_type为authorization_code时

必选 类型及范围 说明

code true string 调用authorize获得的code值。

redirect_uri true string 回调地址，需需与注册应用里的回调地址一致。

返回数据

{

“access_token”: “ACCESS_TOKEN”,

“expires_in”: 1234,

“remind_in”:”798114”,

“uid”:”12341234”

}

返回值字段 字段类型 字段说明

access_token string 用于调用access_token，接口获取授权后的access token。

expires_in string access_token的生命周期，单位是秒数。

remind_in string access_token的生命周期（该参数即将废弃，开发者请使用expires_in）。

uid string 当前授权用户的UID。

二、 微博的读取

1、statuses/public_timeline

返回最新的公共微博

URL

/2/statuses/public_timeline.json

支持格式

JSON

HTTP请求方式

GET

是否需要登录

是

关于登录授权，参见 如何登录授权

访问授权限制

访问级别：普通接口

频次限制：是

关于频次限制，参见 接口访问权限说明

请求参数

必选 类型及范围 说明

source false string 采用OAuth授权方式不需要此参数，其他授权方式为必填参数，数值为应用的AppKey。

access_token false string 采用OAuth授权方式为必填参数，其他授权方式不需要此参数，OAuth授权后获得。

count false int 单页返回的记录条数，默认为50。

page false int 返回结果的页码，默认为1。

base_app false int 是否只获取当前应用的数据。0为否（所有数据），1为是（仅当前应用），默认为0。

注意事项

无

调用样例及调试工具

API测试工具

返回结果

JSON示例

{

“statuses”: [

{

“created_at”: “Tue May 31 17:46:55 +0800 ”,

“id”: 11488058246,

“text”: “求关注。”，

“source”: “新浪微博“,

“favorited”: false,

“truncated”: false,

“in_reply_to_status_id”: “”,

“in_reply_to_user_id”: “”,

“in_reply_to_screen_name”: “”,

“geo”: null,

“mid”: “5612814510546515491”,

“reposts_count”: 8,

“comments_count”: 9,

“annotations”: [],

“user”: {

“id”: 1404376560,

“screen_name”: “zaku”,

“name”: “zaku”,

“province”: “11”,

“city”: “5”,

“location”: “北京 朝阳区”,

“description”: “人生五十年，乃如梦如幻；有生斯有死，壮士复何憾。”,

“url”: “/zaku“,

“profile_image_url”: “/1404376560/50/0/1“,

“domain”: “zaku”,

“gender”: “m”,

“followers_count”: 1204,

“friends_count”: 447,

“statuses_count”: 2908,

“favourites_count”: 0,

“created_at”: “Fri Aug 28 00:00:00 +0800 ”,

“following”: false,

“allow_all_act_msg”: false,

“remark”: “”,

“geo_enabled”: true,

“verified”: false,

“allow_all_comment”: true,

“avatar_large”: “/1404376560/180/0/1“,

“verified_reason”: “”,

“follow_me”: false,

“online_status”: 0,

“bi_followers_count”: 215

}

},

..

],

“previous_cursor”: 0,

“next_cursor”: 11488013766,

“total_number”: 81655

}

关于错误返回值与错误代码，参见 错误代码说明

返回字段说明

返回值字段 字段类型 字段说明

created_at string 微博创建时间

id int64 微博ID

mid int64 微博MID

idstr string 字符串型的微博ID

text string 微博信息内容

source string 微博来源

favorited boolean 是否已收藏，true：是，false：否

truncated boolean 是否被截断，true：是，false：否

in_reply_to_status_id string （暂未支持）回复ID

in_reply_to_user_id string （暂未支持）回复人UID

in_reply_to_screen_name string （暂未支持）回复人昵称

thumbnail_pic string 缩略图片地址，没有时不返回此字段

bmiddle_pic string 中等尺寸图片地址，没有时不返回此字段

original_pic string 原始图片地址，没有时不返回此字段

geo object 地理信息字段 详细

user object 微博作者的用户信息字段 详细

retweeted_status object 被转发的原微博信息字段，当该微博为转发微博时返回 详细

reposts_count int 转发数

comments_count int 评论数

attitudes_count int 表态数

mlevel int 暂未支持

visible object 微博的可见性及指定可见分组信息。该object中type取值，0：普通微博，1：私密微博，3：指定分组微博，4：密友微博；list_id为分组的组号

pic_ids object 微博配图ID。多图时返回多图ID，用来拼接图片url。用返回字段thumbnail_pic的地址配上该返回字段的图片ID，即可得到多个图片url。

ad object array 微博流内的推广微博ID