题记：我的API入门学习笔记，欢迎交流指正。本文在博客园也有发布：https://www.cnblogs.com/codestack123/p/10816013.html，里增加了一些配图。
回顾API使用的流程
通过百度地图API的使用，我理解API调用的一般流程为：生成API规定格式的url->通过urllib读取url中数据->对json格式的数据进行解析。下一步，开始研究新浪微博API的使用。
准备
新浪微博开放平台是新浪微博API的使用平台。
用微博账号登录该平台后，申请成为开发者，创建一个新应用后会得到唯一的App Key和App Secret。（注：应用不需要提交审核，只要创建新应用系统就会分配Key和Secret）在"我的应用/应用信息/基本信息"中也可以查到这两个信息。在这一页面中还有”我的应用/应用信息/高级信息“一项，点击进入并设置OAuth2.0授权回调页相关信息，如果不知道填什么好，可以设置为默认回调页：https://api.weibo.com/oauth2/default.html。这三项信息都是后面需要用到的，请复制保存到文档。
微博API新特点
与百度地图API相比，新浪微博API增加了OAuth2.0协议用于用户身份验证和授权。这里仅作简要说明（感兴趣的同学请查看网上文档示意图）：通过该协议，第三方应用可以获得用户授权，然后用该许可从授权服务器获得令牌(Token)，用于后续从API服务器查询数据时验证身份。
这一验证环节增加了url生成的复杂度，好在网站上已经有廖雪峰老师提供的SDK工具包:sinaweibopy（廖老师的github地址好像改过名字，因此网上很多旧链接无效，这个是新的有效链接），但是这一程序是基于python2环境编写的，python3有些系统库有更改，程序调用时经常报错。而作为python入门者，改写程序以适应python3环境无疑是一件困难的事。幸好有大神做了这一工作，感谢owolf针对python3改写的SDK:sinaweibopy3，我使用过，正常运行，大家可以下载。在这里同时推荐owolf的文章全网最详：python3调用新浪微博API接口获取数据。
简单示例
下面介绍一下我使用新浪微博API的过程，为新入门的同学提供参考。
1.参数设置
import sinaweibopy3
import webbrowser
import json
APP_KEY =' 填入你的App Key'
APP_SECRET=' 填入你的App Secret'
REDIRECT_URL =' 填入你的授权回调页'
注：
- 该文件需要和sinaweibopy3.py放在同一个文件夹里。
- 填写的三项信息都是在准备中提到的信息。
这里谈谈我粗心大意造成的一个bug，也给大家提个醒。一开始我运行程序时，每次都出现“重定向地址不匹配”的错误信息：
用微博帐号登录出错了！对第三方应用进行授权时出现错误，请您联系第三方应用的开发者：XXX 或者稍后再试。
错误码：21322 重定向地址不匹配
查找网上的解决方法，要设置回调页，但是在前面的步骤里我已经设置了，怎么还会有这个问题？后来看到一篇文章中提到回调页地址和程序中的REDIRECT_URL要一致，我想到了程序示例是http://api.weibo.com/oauth2/default.html，用的是http:开头，我在填写时看到地址一样，就没有改动，而网站上是https:开头，一个's'之差，当时觉得是一个地址，没想到相差大矣！
2.OAuth2.0验证生成url
client = sinaweibopy3.APIClient(app_key=APP_KEY, app_secret=APP_SECRET, redirect_uri=REDIRECT_URL)
url = client.get_authorize_url()
webbrowser.open_new(url)
result = client.request_access_token(input("please input code: "))
client.set_access_token(result.access_token, result.expires_in)
注意：这就是调用sinaweibopy3，实现OAuth2.0中用户授权->获取Token这一过程。当程序运行到client.request_access_token时，会弹出输入提示"please input code: "，要求输入code？这是什么意思呢？打开浏览器就会看到出现了OAuth2.0验证回调页，地址栏一项'code='后面有一串字符，这就是我们要的Token信息，把它复制后粘贴输入，程序继续运行。
3.从API读取数据
运行下列代码，可以读取公共微博的数据并显示结果。
result=client.public_timeline()
print(json.dumps(result,indent=2,ensure_ascii=False))
而通过查看数据结构，可以提取特定信息。例如用以下代码输出用户微博昵称、地点和最新微博正文。
number=result["total_number"]
print(number,"users:")
for u in result["statuses"]:
print(u["user"]["screen_name"])
print(u["user"]["location"])
print(u["text"])
进阶
如果要查询其他信息，比如获取用户的关注列表，怎么办呢？让我们来试着编写出相应的函数。
1.查看新浪微博API定义的url: https://api.weibo.com/2/friendships/friends.json
以及定义的请求参数：access_token, uid, screen_name, count, cursor, time_status。
其中access_token需要填写，uid和screen_name分别是用户id和昵称，二者必填且只填一项。（注：接口升级后，只能为当前授权用户） count, cursor可使用默认参数。count是单页返回记录条数，默认为5，最大不超过5，cursor返回结果的游标。trim_status是显示status字段的开关，0：返回完整status字段，1：仅返回status_id，默认为1。
2.在sinaweibopy3.py中是如何实现public_timeline()呢：
def public_timeline(self):
result = _http_get('%s'% (self.api_url) + 'statuses/public_timeline.json',
access_token=self.access_token,
count=50,
page=1,
base_app=0,
)
return result
对照代码发现%s'% (self.api_url)就是https://api.weibo.com/2，我们只需要把 'statuses/public_timeline.json'改成'friendships/friends.json'，并添加必填的请求参数，可以写出一个类似的函数：
def fs_friends(self):
result=_http_get('%s'% (self.api_url) + 'friendships/friends.json', access_token=self.access_token,
screen_name='填入你自己的微博昵称' ,
trim_status=0,
)
return result
注：trim_status默认为1，设置为0才会得到完整status字段（其中包括最新微博正文）。
3.在自己的主程序中调用fs_friends()函数
参考原有的client.public_timeline()，得到以下代码：
result = client.fs_friends()
print(json.dumps(result,indent=2,ensure_ascii=False))
这样就可以看到关注的人的列表，包括基本信息及最新微博。编写以下代码，提取最新微博内容：
for u in result['users']:
print("\n",u['screen_name'])
print(u['location'])
if('status' not in u):
print('not found\n')
continue
print(u['status']['text'])
以下是我还在思考的问题，欢迎交流指教，谢谢！
1、请求参数设置里count不大于5，我在实际运行程序时只看到4个关注用户及微博正文，能否读取更多用户，如何读取？
2、我还尝试了编写statuses/home_timeline(获取当前登录用户及其所关注（授权）用户的最新微博)的查询函数，但是因为参数设置问题，显示结果为Null（空）。我认为问题出在max_id参数上，说明中指出：若指定此参数，则返回ID小于或等于max_id的微博，默认为0，但是设多大合理？我有些困惑。