Bỏ qua đến nội dung chính
Mục lục

Gọi API bằng requests trong Python

AIDev Team · duyệt: Nguyễn Việt Chung

Bài 1/8 · Chương 22

Mạng, giao diện và tự động hóa

  • 8 phút
  • Trung cấp
  • Python 3.14
  • Cập nhật

Thư viện requests trong Python gửi yêu cầu tới một API (địa chỉ mà một dịch vụ mở ra cho chương trình khác lấy dữ liệu) và trả về câu trả lời của máy chủ chỉ sau một lời gọi. Bạn dùng nó khi một công cụ nhỏ cần lấy tỷ giá hay dự báo thời tiết mỗi sáng thay vì mở trình duyệt chép tay.

Cần biết trước: pip, JSON và try/except.

Gửi yêu cầu GET bằng requests.get()

Trình duyệt mở một trang bằng cách gửi yêu cầu GET (xin dữ liệu) qua giao thức HTTP. Một API cũng nhận yêu cầu GET, nhưng trả về dữ liệu cho chương trình đọc, thường ở dạng JSON. requests không có sẵn trong Python, nên bạn cài nó vào môi trường ảo của dự án:

bash
python -m pip install requests

Trên macOS/Linux, gõ python3 thay cho python nếu máy chưa có lệnh python. Trình chạy trên trang không có mạng và không có requests, nên các khối gọi requests của bài không có nút Chạy. Để không gọi API của ai, các kết quả dưới đây đều là của một lần chạy trong Docker image python:3.14-slim với requests 2.34.2, gọi một máy chủ thử trên chính máy đó. Máy chủ thử là lệnh python -m http.server 8000 chạy trong thư mục có file ty-gia.json, nội dung {"tu": "USD", "ngay": "14/11/2026", "rates": {"VND": 25480.0, "EUR": 0.86}} (số liệu đặt ra cho bài). Máy chủ thử chạy mãi trong cửa sổ terminal của nó, nên bạn chạy các file của bài trong một cửa sổ terminal khác. File ty_gia.py:

python
import requests

url = "http://localhost:8000/ty-gia.json"
tra_loi = requests.get(url, timeout=10)
print(tra_loi.status_code)
print(tra_loi.headers["Content-Type"])
du_lieu = tra_loi.json()
print(type(du_lieu).__name__)
print("1 USD =", du_lieu["rates"]["VND"], "VND")
bash
python ty_gia.py

KẾT QUẢ

200
application/json
dict
1 USD = 25480.0 VND

requests.get() trả về một đối tượng câu trả lời (Response). timeout=10 là số giây tối đa chờ máy chủ: thiếu nó, requests có thể chờ mãi khi máy chủ im lặng. status_code là mã trạng thái HTTP, 200 nghĩa là thành công.

Đọc dữ liệu JSON bằng .json()

.json() đọc thân câu trả lời và đổi nó thành dict, như json.loads() làm với một chuỗi. Dữ liệu của API thường là dict lồng nhau, nên bạn tra nhiều tầng. Khối dưới dùng json.loads() trên đúng chuỗi mà máy chủ thử trả về, nên chạy được ngay trên trang:

python
import json

van_ban = '{"tu": "USD", "rates": {"VND": 25480.0, "EUR": 0.86}}'
du_lieu = json.loads(van_ban)
print(du_lieu["rates"]["EUR"])
print(du_lieu["rates"].get("JPY"))

KẾT QUẢ

0.86
None

Đổi "JPY" thành "VND" rồi chạy lại: dòng thứ hai in 25480.0. Mã tiền mà API không có thì get() trả về None thay cho báo lỗi.

Mã trạng thái và raise_for_status()

Câu trả lời nào của máy chủ cũng kèm một mã: 200 là được, 404 là không có trang, 500 là máy chủ hỏng. requests không tự báo lỗi khi mã là 404, nó trả về câu trả lời như thường. File kiem_tra_ma.py xin một file không có:

python
import requests

url = "http://localhost:8000/khong-co.json"
tra_loi = requests.get(url, timeout=10)
print(tra_loi.status_code, tra_loi.ok)
try:
    tra_loi.raise_for_status()
except requests.HTTPError as loi:
    print("Lỗi:", loi)
bash
python kiem_tra_ma.py

KẾT QUẢ

404 False
Lỗi: 404 Client Error: File not found for url: http://localhost:8000/khong-co.json

ok là True khi mã nhỏ hơn 400. raise_for_status() không làm gì với câu trả lời tốt, còn với mã từ 400 trở lên thì báo requests.HTTPError. Gọi nó ngay sau get(), trước .json(): thân của một trang lỗi thường là HTML, không đọc được thành dict.

Tham số truy vấn với params=

API thời tiết hay tỷ giá nhận điều kiện qua chuỗi sau dấu ? của URL, như ?thanh_pho=Huế. Bạn đưa một dict cho params=, requests tự mã hóa chữ có dấu, dấu cách và dấu / rồi ghép vào URL. File tham_so.py:

python
import requests

tham_so = {"thanh_pho": "Đà Lạt", "ngay": "14/11/2026"}
url = "http://localhost:8000/ty-gia.json"
tra_loi = requests.get(url, params=tham_so, timeout=10)
print(tra_loi.url)
print(tra_loi.status_code)
bash
python tham_so.py

KẾT QUẢ

http://localhost:8000/ty-gia.json?thanh_pho=%C4%90%C3%A0+L%E1%BA%A1t&ngay=14%2F11%2F2026
200

tra_loi.url là URL thật đã gửi. Máy chủ thử chỉ đọc file nên bỏ qua tham số, còn một API thật dùng chúng để chọn dữ liệu. Tự nối chuỗi thì &, = hay # nằm trong giá trị không được mã hóa: "?q=" + "A&B" bị máy chủ đọc thành hai tham số.

Bắt lỗi mạng bằng requests.RequestException

Lỗi khi gọi API có nhiều dạng: máy chủ trả mã lỗi (HTTPError), không kết nối được (ConnectionError), chờ quá timeout (Timeout). Cả ba là lớp con của requests.RequestException, nên một nhánh except đón được hết, đúng cách bắt nhiều loại lỗi bằng lớp cha. File bat_loi.py gọi một file có, một file không có và một cổng 8001 không có máy chủ nào:

python
import requests

cac_url = ["http://localhost:8000/ty-gia.json",
           "http://localhost:8000/khong-co.json",
           "http://localhost:8001/ty-gia.json"]
for url in cac_url:
    try:
        tra_loi = requests.get(url, timeout=5)
        tra_loi.raise_for_status()
        print("Được:", tra_loi.json()["rates"]["VND"])
    except requests.RequestException as loi:
        print("Lỗi", type(loi).__name__, "ở", url)
bash
python bat_loi.py

KẾT QUẢ

Được: 25480.0
Lỗi HTTPError ở http://localhost:8000/khong-co.json
Lỗi ConnectionError ở http://localhost:8001/ty-gia.json

Vòng lặp chạy tiếp sau mỗi lỗi, vì try chỉ bọc phần gọi mạng của một URL. Bỏ dòng raise_for_status() thì URL thứ hai vẫn vào nhánh lỗi, nhưng muộn hơn, ở .json(), với tên JSONDecodeError: dòng in ra không còn cho biết máy chủ đã trả mã 404.

Gửi dữ liệu lên API, như nộp một báo cáo, dùng yêu cầu POST: requests.post(url, json=du_lieu, timeout=10) đổi dict thành JSON và gửi trong thân yêu cầu. File gui_bao_cao.py gửi tới máy chủ thử, vốn chỉ biết trả file:

python
import requests

bao_cao = {"ngay": "14/11/2026", "so_lan_goi": 3}
url = "http://localhost:8000/bao-cao"
tra_loi = requests.post(url, json=bao_cao, timeout=10)
print(tra_loi.request.headers["Content-Type"])
print(tra_loi.request.body)
print(tra_loi.status_code)
bash
python gui_bao_cao.py

KẾT QUẢ

application/json
b'{"ngay": "14/11/2026", "so_lan_goi": 3}'
501

tra_loi.request là yêu cầu requests đã gửi: thân là JSON ở dạng bytes. Mã 501 là máy chủ thử nói nó không xử lý POST. Một API nhận báo cáo thật thường trả 200 hay 201.

Kiểm tra nhanh

  1. Trong ví dụ gọi khong-co.json, dòng print(tra_loi.status_code, tra_loi.ok) in ra gì?

    • 200 True
    • 404 False
    • 404 True
    • Không in gì, requests.get() báo HTTPError trước
  2. Những điều nào đúng về lời gọi requests.get(url, params=tham_so, timeout=10)?

    • params= mã hóa dict tham_so rồi ghép vào URL sau dấu ?
    • timeout=10 bảo requests thử lại 10 lần khi lỗi
    • timeout=10 là số giây tối đa chờ máy chủ trả lời
    • Mã 404 làm lời gọi này báo lỗi ngay
  3. Sau van_ban = '{"rates": {}}', van_ban["rates"] báo lỗi gì?

    • {}
    • Báo lỗi KeyError
    • Báo lỗi TypeError
  4. Trong ví dụ bắt lỗi ba URL, vì sao một nhánh except requests.RequestException bắt được cả lỗi 404 lẫn lỗi không kết nối?

    • HTTPError và ConnectionError đều là lớp con của RequestException
    • requests đổi mọi lỗi mạng thành ValueError
    • raise_for_status() biến lỗi kết nối thành lỗi 404
Đúng hết lần đầu +15 XP

Bài tập

Đọc tỷ giá từ câu trả lời của API

Một công cụ đổi tiền gọi requests.get() rồi đưa câu trả lời cho hàm lay_ty_gia(tra_loi, ma). Viết thân hàm. Khi tra_loi.status_code khác 200, hàm trả về None và không gọi tra_loi.json(), vì thân của câu trả lời lỗi không phải JSON. Khi mã là 200, hàm đọc dict bằng tra_loi.json() rồi trả về giá trị của ma trong dict con "rates", hoặc None khi ma không có. Trình chấm dùng câu trả lời giả có status_code và json() như của requests.

Ví dụ: câu trả lời mã 200 có thân {"tu": "USD", "rates": {"VND": 25480.0, "EUR": 0.86}} thì lay_ty_gia(tra_loi, "VND") trả về 25480.0.

Trả về: tỷ giá, một float, hoặc None.

python
def lay_ty_gia(tra_loi, ma):
    pass  # Viết thân hàm thay cho dòng này

Tóm tắt

  • requests.get(url, timeout=10) gửi yêu cầu GET và trả về câu trả lời; đặt timeout để không chờ mãi.

  • status_code là mã trạng thái: 200 là được, 404 là không có, và requests không tự báo lỗi với mã đó.

  • raise_for_status() báo requests.HTTPError khi mã từ 400 trở lên; gọi nó trước .json().

  • .json() đổi thân JSON thành dict lồng nhau; .text chỉ là chuỗi.

  • params= nhận dict và tự mã hóa tham số truy vấn; requests.post(url, json=...) gửi dữ liệu lên.

  • except requests.RequestException đón cả lỗi mã trạng thái, lỗi kết nối và lỗi hết giờ chờ.

Câu hỏi thường gặp

Gọi API bằng Python mà không cài thêm thư viện được không?

Được, bằng urllib.request có sẵn trong Python. Bạn tự mã hóa tham số và tự đổi bytes sang chuỗi trước khi đưa cho json.loads(), nên code dài hơn với requests. Bài urllib dạy urlopen() và cách bắt lỗi của nó.

Vì sao Python báo ModuleNotFoundError khi import requests dù đã cài?

Lệnh cài và lệnh chạy dùng hai bản Python khác nhau, thường vì quên kích hoạt môi trường ảo hay trình soạn code chọn sai Python. Cài bằng python -m pip install requests với đúng lệnh python mà bạn dùng để chạy file. Bài ModuleNotFoundError kể các nguyên nhân khác.

Đặt timeout bao nhiêu giây khi call API bằng Python?

requests không có thời hạn mặc định, nên lời gọi thiếu timeout có thể đứng mãi. Vài giây, như timeout=10, hợp với API trả lời nhanh. Bạn còn truyền được một tuple, như timeout=(3, 10): số đầu là thời gian chờ kết nối, số sau là thời gian chờ dữ liệu.

Gọi nhiều API cùng lúc thì làm thế nào cho nhanh?

Mỗi lời gọi requests.get() chờ máy chủ xong mới chạy tiếp, nên mười API là mười lần chờ nối nhau. Để chờ cùng lúc, bạn chia lời gọi cho nhiều luồng hay dùng thư viện bất đồng bộ, như bài asyncio.gather() giới thiệu.

Chủ đề

requests python

Bài này có hữu ích?

Hỏi đáp

Đang tải câu hỏi…

Tham vấn chuyên môn

Nguyễn Việt Chung

Nhà sáng lập AIDev và VietPlatform · Thạc sĩ AI MSE

  • Tốt nghiệp thủ khoa xuất sắc Thạc sĩ AI MSE.
  • Đồng sáng lập, CTO E-University, SVOnline: số hóa 10+ đại học, 40.000+ sinh viên.
  • Xây hệ thống AI cho doanh nghiệp tại VietPlatform.
Biên soạn: AIDev Team · Rà soát · Quy trình biên tập