Requests 是用Python语言编写,基于 urllib,采用 Apache2 Licensed 开源协议的 HTTP 库。它比 urllib 更加方便,可以节约我们大量的工作,完全满足 HTTP 测试需求。Requests 的哲学是以 PEP 20 的习语为中心开发的,所以它比 urllib 更加 Pythoner。
一、安装
使pip安装:
pip install requests
安装完后,运行一个简单的例子查看是否安装成功:
1. import requests #导入requests包 2. r=requests.get(url=‘https://www.baidu.com/‘) 3. print(r.status_code) #查看请求返回的状态 4. #结果 5. 200
二、几种请求类型
①get请求:requests.get(‘url‘)
②post请求:requests.post("url/post")
③put请求:requests.put("url/put")
④delete请求:requests.delete("url/delete")
⑤head请求:requests.head("url/get")
⑥options请求:requests.options("url/get")
三、get请求
传递url参数
在get请求中,允许使用params关键字,以一个字典来传递这些参数,例如:
1. content={‘pageIndex‘:1,‘pageSize‘:10,‘categoryId‘:9} 2. r=requests.get(‘http://www.xxxxx.com/api/v2/activities‘,params=content) 3. print (r.url) #获取请求内容 4. print (r.text) #获取响应内容 5. #结果 6. http://www.xxxx.com/api/v2/activities?pageIndex=1&pageSize=10&categoryId=9 7. {"data":[],"pageIndex":1,"totalNum":0,"hasMore":false,"pageSize":0}
如果字典中存在None的值,是不会添加到url请求中的
1. content={‘pageIndex‘:1,‘pageSize‘:10,‘categoryId‘:None} 2. r=requests.get(‘http://www.xxxxx.com/api/v2/activities‘,params=content) 3. print (r.url) 4. 5. #结果 6. http://www.xxxx.com/api/v2/activities?pageIndex=1&pageSize=10
ps:不使用params的话,也可在请求中输入全部的地址,效果相同,如:
r=requests.get(‘http://m.xxxxx.com/api/v2/activities?pageIndex=1&pageSize=10&categoryId=9‘)
注意:在某些get请求中,需要辨别用户身份,因此会需要在请求中发送cookie内容,如某些需要用户登录才能访问的页面,在接下来的文章中会进行讲解
四、post请求
1.以表单形式传递参数:
想要发送一些表单形式的数据,只需简单的传递一个字典给data关键字,在发送请求的时候,会自动编码为表单的形式,例如:
1. content={‘key1‘:‘value1‘,‘key2‘:‘value2‘} 2. r=requests.post(‘http://www.xxx/api/v1/user/login‘,data=content)
2.以json形式传递参数:
在很多情况下,想要发送的数据并非为表单形式,而是一个json格式的字符串,如果传递给data关键字的内容不是一个dict,而是
一个string,那么在发送的时候,数据会被直接发送出去,不会自动编码为表单形式。
为了将一个数据结构转换为json格式的字符串,首先得需要导入一个json包,两种常用的方法为:json.dumps()与json.loads()
1. import json 2. content={‘name‘:‘Nee‘,‘age‘:‘18‘} 3. str_content=json.dumps(content) #把dick编码为json格式的字符串 4. print (str_content) 5. print (type(str_content)) 6. #结果: 7. {"name": "Nee", "age": "18"} 8. <class ‘str‘> 9. #此时的类型为str 10. #把json格式的字符串解码为原先的数据结构 11. content=json.loads(str_content) 12. print (content) 13. print (type(content)) 14. #结果 15. {‘name‘: ‘Nee‘, ‘age‘: ‘18‘} 16. <class ‘dict‘> 17.
注意:1.json编码支持的基本类型有:None, bool, int, float, string, list, tuple, dict。对于字典,json会假设key是字符串(字典中的任何非字符串key都会在编 码时转换为字符串),要符合JSON规范,应该只对python列表和字典进行编码。此外,在WEB应用中,把最顶层对象定义为字典是一种标准做法。 2.json编码的格式几乎和python语法一致,略有不同的是:True会被映射为true,False会被映射为false,None会被映射为null,元组()会被映射为列表[],如:
1. content={‘a‘:None,‘b‘:True,‘c‘:False,‘d‘:(1,2)} 2. str_content=json.dumps(content) 3. print (str_content) 4. 5. #结果: 6. {"a": null, "b": true, "c": false, "d": [1, 2]}
想要在post请求中使用data关键字来传递json格式的字符窜,首先得把dict转为string,例如:
1. import requests 2. import json 3. url=‘http://www.xxx.com/api/v1/user/login‘ 4. data={"un":"xxxxx","pw":"xxxxxx","ct":12} 5. r=requests.post(url,data=json.dumps(data)) #在一些post请求中,还需要用到headers部分,此处未加,在下文中会说到 6. print (r.text) 7. 8. #结果 9. {"newUser":false,"user":{"userId":531,"mobileNo":"13700002000","userName":"测试用户2000".......}
除了可以对dick编码后以string的方式传递参数外,还可以直接使用json关键字直接传递,在传递时会自行进行编码为string类型
1. import requests #不需要导入json模块 2. url=‘http://xxxx/api/v1/user/login‘ 3. data={"un":"xxxxxxx","pw":"xxxxx","ct":12} 4. r=requests.post(url,json=data)
在post请求中用到的head部分和cookie部分。在之后的文章中会进行讲解
五、响应
1.响应状态
在请求发送成功后,可以用status_code来查看相应状态
1. import requests 2. r=requests.get(url) 3. print(r.status_code) 4. 5. -----结果----- 6. 200
下面是常见的HTTP状态码:
200 - 请求成功
301 - 资源(网页等)被永久转移到其它URL
404 - 请求的资源(网页等)不存在
500 - 内部服务器错误
HTTP状态码由三个十进制数字组成,第一个十进制数字定义了状态码的类型,后两个数字没有分类的作用。HTTP状态码共分为5种类型:
HTTP状态码分类
分类 | 分类描述 |
1** | 信息,服务器收到请求,需要请求者继续执行操作 |
2** | 成功,操作被成功接收并处理 |
3** | 重定向,需要进一步的操作以完成请求 |
4** | 客户端错误,请求包含语法错误或无法完成请求 |
5** | 服务器错误,服务器在处理请求的过程中发生了错误 |
2.响应内容
在上面的内容中,已经展示了用text来获取相应的内容,返回的内容为string
1. import requests 2. r=requests.get(url) 3. print (r.text) 4. print (type(r.text)) #查看返回内容的类型 5. 6. -----结果----- 7. .......... #返回的具体内容 8. <class ‘str‘> #类型为string
除此之外,requests中也带有带有一个内置的json解码器,将返回的内容转换为dict
1. import requests 2. r.requests.get(url) 3. print (r.json()) 4. print (type(r.json())) 5. 6. -----结果----- 7. ...... 8. <class ‘dict‘>
那么通过json解码器转为dict后,想要查看到返回内容中某个具体参数的值,就比较方便啦!
3.响应内容编码格式
在获取响应内容的时候,可以使用r.encoding来查看相应内容的编码格式
1. import requests 2. r=requests.get(url) 3. print(r.encoding) 4. 5. -----结果----- 6. UTF-8
也可以进行指定编码,当改变了编码方式是后,每次获取响应内容,都会使用新的编码方式(建议在所有情况下都使用utf-8,如果你对编码一点都不了解,那使用utf-8就对了!)
1. import requests 2. r=requests.get(url) 3. r.encoding=‘ISO-8859-1‘ 4. print(r.text)
4.响应头内容
1. import requests 2. r=requests.get(url) 3. print (r.headers)
5.cookies
1. import requests 2. r=requests.get(url) 3. print (r.cookies) 4.