3、requests之不同型別的傳參

上一篇，我們介紹了幾種種帶引數的請求型別劃分，這篇，通過github上的API，來一個個的引數介面的演示，
1、不帶引數的get請求

# 匯入requests包
import requests 

# 1. 組裝請求
url = "https://api.github.com"  # 這里只有url，字串格式
# 2. 發送請求，獲取回應
res = requests.get(url) # res即回傳的回應物件
# 3. 決議回應
print(res.json)  # 輸出回應的文本

res.json()方法實際上是使用了json.loads(res.text)將回應文本嘗試以JSON格式轉為字典，由于該方法存在例外（比如正常情況下回傳JSON格式，500報錯時則會回傳非JSON格式的報錯資訊），建議使用try…except處理，修改如下，

import requests
url = 'https://api.github.com'
url_params = {'name': '浩浩', 'age': '18'}
res = requests.get(url, params=url_params)
try:
    print('回應文本轉為字典', res.json())
except:
    print('回應文本', res.text)

2、帶引數的get請求

import requests 

url = "https://api.github.com/openapi/api?key=ec961279f453459b9248f0aeb6600bbe&info=你好"  # 引數可以寫到url里
res = requests.get(url=url) # 第一個url指get方法的引數，第二個url指上一行我們定義的介面地址
print(res.text)  

URL只支持ASCII(美國標準碼)，在實際的傳輸程序中，中文及一些特殊字符需要經過urlencode(URL編碼)，如上例中的介面地址會被編碼成：
https://api.github.com/get?name=%E4%B8%B4%E6%B8%8A&age=18

或者這樣寫`

import requests 

url = "https://api.github.com/openapi/api"
params = {"key":"ec961279f453459b9248f0aeb6600bbe","info":"你好"} # 字典格式，單獨提出來，方便引數的添加修改等操作
res = requests.get(url=url, params=params) 
print(res.text)  

需要注意的是，requests.get（）方法中,引數params后面跟著是一個字典，requests會自動幫我們把這個引數拼接在介面請求地址中
3、傳統表單類POST請求（x-www-form-urlencoded）

import requests 

url = "https://api.github.com"
data = {"name": "浩浩", "age": 18} # Post請求發送的資料，字典格式
res = requests.post(url=url, data=data) # 這里使用post方法，引數和get方法一樣
print(res.text)  

4、JSON型別的POST請求（application/json）

import requests 

url = "https://api.github.com"
data = '''{
        "name": "浩浩",
        "age": 18
        }''' # 多行文本, 字串格式，也可以單行（注意外層有引號，為字串） data = '{"name": "浩浩", "age": 18}'
res = requests.post(url=url, data=data) #  data支持字典或字串
print(res.text)  

data引數支持字典格式也支持字串格式，如果是字典格式，requests方法會將其按照默認表單urlencoded格式轉換為字串，如果是字串則不轉化
如果data以字串格式傳輸需要遵循以下幾點：

必須是嚴格的JSON格式字串，里面必須用雙引號，k-v之間必須有逗號，布林值必須是小寫的true/false等等
不能有中文，直接傳字串不會自動編碼
一般來說，建議將data宣告為字典格式（方便資料添加修改），然后再用json.dumps()方法把data轉換為合法的JSON字串格式

import requests 
import json # 使用到JSON中的方法，需要提前匯入

url = "https://api.github.com"
data = {
        "name": "浩浩",
        "age": 18
        }  # 字典格式，方便添加
headers = {"Content-Type":"application/json"} # 嚴格來說，我們需要在請求頭里宣告我們發送的格式
res = requests.post(url=url, data=json.dumps(data), headers=headers) #  將字典格式的data變數轉換為合法的JSON字串傳給post的data引數
print(res.text)  

或直接將字典格式的data資料賦給post方法的JSON引數（會自動將字典格式轉為合法的JSON文本并添加headers）

import requests 

url = "https://api.github.com/openapi/api/v2"
data = {
	"reqType":0,
    "perception": {
        "inputText": {
            "text": "哈哈哈"
        },
        "inputImage": {
            "url": "imageUrl"
        },
        "selfInfo": {
            "location": {
                "city": "北京",
                "province": "北京",
                "street": "古城南街"
            }
        }
    },
    "userInfo": {
        "apiKey": "ec961279f453459b9248f0aeb6600bbe",
        "userId": "206379"
    }
} 
res = requests.post(url=url, json=data) # JSON格式的請求，將資料賦給json引數
print(res.text)  

5、發送XML格式的資料
上例提到XML和JSON都屬于Raw格式的資料，XML和JSON在Python中實際都是不同格式的文本字串，我們將字串傳遞給請求方法的data引數即可原樣發送，即data引數有以下3重作用：

1）data = {} 或 [(,), (,)]：接受一個字典或嵌套串列格式的資料，會按表單Url編碼格式
2）data = ‘’：接受一個字串或bytes二進制字串，會原樣發送（需要手動添加請求頭，如果存在中文需要手動編碼）
3）data = open(’…’, ‘rb’)：接受一個檔案物件，按binary格式流式上傳，
發送XML格式的資料只要將XML格式的多行字串傳遞給請求方法的data引數即可，示例如下，

import requests
url = 'https://api.github.com/post'
xml_data = '''
<xml>
    <name>浩浩</name>
    <age>18</name>
</xml>
'''
headers = {'Content-Type': 'application/xml'}

res = requests.post(url, data=xml_data.encode('utf-8'), headers=headers)
print(res.text)

由于xml_data資料中存在非ASCII碼，需要將資料按utf-8格式編碼為bytes二進制字串發送，由于使用Raw格式發送資料時不會自動添加請求頭，因此一般要手動在請求頭中添加內容型別宣告，并將構造的字典型別的請求頭變數，傳遞給請求方法的關鍵字引數headers，
6、發送Multipart/form-data請求（檔案上傳）
網頁上的表單有兩種，一種是不包含檔案上傳，所有用戶輸入或選擇的資料都可以使用字串格式表示，這種稱為普通表單或純文本表單，對應MIME型別為application/x-www-form-urlencoded，

另一種即包括普通輸入框等，也包含一個或多個檔案上傳框，普通輸入框中的變數值可以已字串格式編碼，而上傳的檔案（如圖片檔案）則不一定能直接轉為字串，要使用二進制格式，因此要使用多部分的混合格式，筆者稱之為混合表單，對應MIME型別為multipart/form-data，在表單中，每個需要上傳的檔案和普通輸入框一樣對應一個指定的變數，因此同樣可以使用字典格式組裝混合表單的請求資料傳遞給請求方法的files引數即可，示例如下，

import requests
url = 'https://api.github.com/post'
multi_form_data = {
    'name': '浩浩',
    'age': '18',  # 不能使用int型別
    'avatar': open('/Users/apple/Pictures/robot.png', 'rb'),
    'avatar2': open('/Users/apple/Pictures/robot.jpg', 'rb'),
}

res = requests.post(url, files=multi_form_data)
print(res.text)

表單資料中的數字要使用字串格式的數字，檔案要以rb二進制格式打開傳輸，支持多個變數以及多個檔案，

檔案型別的資料avatar可以只穿一個打開的檔案物件open(’/Users/apple/Pictures/robot.png’, ‘rb’)，也可以傳遞三個引數：要保存的檔案名，打開的檔案及檔案MIME型別，即

‘avatar’: (‘robot.png’, open(’/Users/apple/Pictures/robot.png’, ‘rb’), ‘image/png’),

比如有些介面上傳Excel檔案時必須宣告檔案名和MIME型別，如：

res = request.post(url, files={'upload_file': 
        ('data.xlsx', 
        open('data.xlsx', 'rb'),
        'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet')
    })

7、發送Binary格式資料（單檔案/流式上傳）

import requests
url = 'https://api.github.com/post'

res = requests.post(url, data=open('/Users/apple/Pictures/robot.jpg', 'rb'))
print(res.text)

這種很少見，了解一下就行，

有什么不明白的可以私我加vx：18547673653 或者qq：1270059901