Dalam pengembangan perangkat lunak modern dengan Python, kebutuhan untuk mengambil data dari server eksternal atau berinteraksi dengan layanan berbasis API (Application Programming Interface) sangatlah tinggi. Pustaka standar yang paling sering diandalkan oleh para pengembang untuk tugas ini adalah requests. Melalui fungsi requests.get(), Anda dapat dengan mudah mengirimkan permintaan HTTP GET ke berbagai endpoint server, mengambil data JSON, memproses parameter URL, hingga mengintegrasikannya dengan layanan kecerdasan buatan mutakhir seperti model Llama 3.2-90b-vision-instruct pada platform IBM watsonx.
Dasar Penggunaan Requests Get di Python
Sebelum menggunakan fungsi GET, pastikan pustaka requests sudah terpasang di lingkungan Python Anda. Jika belum, instalasi dapat dilakukan melalui manajer paket pip dengan perintah terminal pip install requests. Setelah terpasang, Anda dapat mengimpor pustaka tersebut dan mulai melakukan pemanggilan HTTP sederhana.
import requests
response = requests.get('https://api.example.com/data')
print(response.status_code)
print(response.json())Parameter Penting dalam Requests Get
Dalam skenario nyata, permintaan GET sering kali memerlukan parameter tambahan seperti query string, header otentikasi, atau pengaturan batas waktu (timeout). Tabel berikut merangkum parameter utama yang sering digunakan:
| Parameter | Tipe Data | Fungsi Utama | Contoh Penggunaan |
|---|---|---|---|
url |
String | Alamat endpoint target tujuan permintaan HTTP. | requests.get('https://api.com/v1') |
params |
Dictionary / List of Tuples | Menambahkan query string pada URL secara otomatis. | params = {'search': 'python'} |
headers |
Dictionary | Mengirimkan informasi header seperti token otorisasi atau jenis konten. | headers = {'Authorization': 'Bearer TOKEN'} |
timeout |
Integer / Float | Menentukan batas waktu tunggu (detik) sebelum koneksi dibatalkan. | timeout=10 |
Penerapan Lanjutan untuk Kueri AI Multimodal
Pustaka requests juga menjadi fondasi penting saat Anda ingin menghubungkan skrip Python lokal dengan layanan komputasi awan tingkat lanjut. Sebagai contoh, ketika Anda ingin mengirimkan kueri AI multimodal menggunakan model seperti Llama 3.2-90b-vision-instruct melalui platform enterprise IBM watsonx, Anda akan menggunakan metode HTTP POST atau GET tergantung pada spesifikasi endpoint REST API yang disediakan oleh layanan tersebut.
import requests
url = "https://us-south.ml.cloud.ibm.com/ml/v1/text/generation?version=2023-05-29"
headers = {
"Accept": "application/json",
"Content-Type": "application/json",
"Authorization": "Bearer YOUR_ACCESS_TOKEN"
}
# Contoh struktur payload untuk integrasi model watsonx
payload = {
"input": "Jelaskan cara kerja fungsi GET pada Python",
"parameters": {
"decoding_method": "greedy",
"max_new_tokens": 200
},
"model_id": "meta-llama/llama-3-2-90b-vision-instruct",
"project_id": "YOUR_PROJECT_ID"
}
response = requests.post(url, headers=headers, json=payload)
print(response.json())Tips Troubleshooting & Penanganan Kesalahan
Saat berinteraksi dengan API eksternal menggunakan Python, selalu bungkus kode pemanggilan dalam blok try-except serta manfaatkan pengecualian bawaan untuk menghindari program berhenti secara tiba-tiba akibat gangguan jaringan atau kesalahan server.
Pastikan juga untuk selalu memeriksa status kode HTTP yang dikembalikan oleh server. Kode 200 menandakan sukses, sedangkan kode di rentang 4xx menunjukkan kesalahan pada sisi klien (seperti salah autentikasi atau URL tidak ditemukan), dan rentang 5xx menunjukkan adanya gangguan pada server tujuan.