Python HTTP Request Debugging: Cara Melacak dan Mengatasi Error

Debugging HTTP request di Python menuntut visibilitas penuh terhadap payload, header, dan status kode yang dikirim maupun diterima. Masalah umum seperti kegagalan payload JSON, kesalahan header otorisasi, atau timeout dapat diselesaikan secara sistematis dengan mengaktifkan logging tingkat rendah pada pustaka standar http.client atau menggunakan pustaka pihak ketiga seperti requests-toolbelt dan curlify.

Penerapan teknik debugging yang tepat memangkas waktu troubleshooting API integration secara signifikan tanpa harus menebak-nebak isi jaringan. Berikut adalah metode paling efektif untuk melacak dan mendiagnosis HTTP request dalam ekosistem Python.

Metode 1: Mengaktifkan Logging Bawaan http.client

Pustaka requests di Python dibangun di atas modul urllib3 dan http.client. Anda dapat memaksa Python untuk mencetak seluruh lalu lintas HTTP mentah (raw traffic) ke konsol dengan mengonfigurasi modul logging bawaan sebelum kode dieksekusi.

import logging
import http.client
import requests

# Aktifkan debugging tingkat rendah untuk http.client
http.client.HTTPConnection.debuglevel = 1

# Konfigurasi logging standar
logging.basicConfig()
logging.getLogger().setLevel(logging.DEBUG)
requests_log = logging.getLogger("urllib3.connectionpool")
requests_log.setLevel(logging.DEBUG)
requests_log.propagate = True

# Eksekusi request
response = requests.get("https://httpbin.org/get")
print(response.status_code)

Metode 2: Mengubah Request Menjadi Perintah cURL dengan Curlify

Seringkali pengembang perlu menguji ulang request yang sama langsung di terminal menggunakan perintah curl. Pustaka curlify memungkinkan konversi objek requests.PreparedRequest menjadi string perintah cURL yang valid.

import requests
import curlify

url = "https://httpbin.org/post"
payload = {"key": "value"}
headers = {"Authorization": "Bearer token123"}

req = requests.Request('POST', url, json=payload, headers=headers)
prepared = req.prepare()

# Cetak string cURL
print(curlify.to_curl(prepared))

Tabel Perbandingan Alat Debugging HTTP Python

Langkah-Langkah Mengatasi Timeout dan Kesalahan Koneksi

Kesalahan umum dalam HTTP request meliputi ConnectTimeout, ReadTimeout, dan SSLError. Tangani pengecualian ini secara eksplisit dalam blok try-except untuk mendapatkan pesan diagnostik yang akurat:

import requests
from requests.exceptions import Timeout, ConnectionError, HTTPError

try:
    response = requests.get("https://api.example.com/data", timeout=5)
    response.raise_for_status()
except Timeout:
    print("Kesalahan: Request melewati batas waktu (timeout).")
except ConnectionError:
    print("Kesalahan: Gagal terhubung ke server (masalah DNS atau jaringan).")
except HTTPError as err:
    print(f"Kesalahan HTTP: {err} - Status Code: {response.status_code}")
except Exception as err:
    print(f"Kesalahan tak terduga: {err}")

Tips Lapangan untuk Troubleshooting API

• Selalu periksa ulang apakah header Content-Type sudah sesuai dengan format payload (misalnya application/json atau application/x-www-form-urlencoded).
• Gunakan proxy lokal seperti Charles Proxy atau Wireshark dengan mengonfigurasi parameter proxies pada pustaka requests jika debugging membutuhkan analisis lalu lintas HTTPS yang mendalam.
• Pastikan verifikasi SSL (verify=True) tidak dinonaktifkan di lingkungan produksi untuk mencegah celah keamanan Man-in-the-Middle (MitM).