Menghubungkan GitHub API Dengan Aplikasi Python Untuk Pemula

Python adalah salah satu bahasa pemrograman yang paling populer karena sintaksnya yang sederhana dan fleksibilitasnya yang tinggi. Salah satu kemampuan yang sering dimanfaatkan oleh pengembang adalah menghubungkan Python dengan API untuk mengambil dan mengolah data. Dalam konteks pengembangan antarmuka atau integrasi layanan, GitHub API menjadi salah satu yang paling banyak digunakan, terutama oleh para pengembang perangkat lunak yang ingin memanfaatkan data dari repositori mereka.

Artikel ini akan membahas langkah demi langkah cara menghubungkan GitHub API dengan aplikasi Python, mulai dari persiapan hingga implementasi dasar. Panduan ini dirancang agar mudah diikuti, bahkan bagi pemula yang baru mengenal API.

Memahami Dasar GitHub API
GitHub API memungkinkan kita mengakses berbagai data yang tersedia di platform GitHub, seperti daftar repositori, informasi pengguna, commit terbaru, hingga data issue. API ini tersedia dalam format REST dan GraphQL, namun untuk tahap awal, REST API biasanya lebih mudah digunakan.

Untuk data publik, kita dapat mengakses API tanpa autentikasi. Namun, jika ingin mengambil data pribadi atau meningkatkan batas permintaan (rate limit), kita memerlukan Personal Access Token yang bisa dibuat langsung di pengaturan akun GitHub.

Menyiapkan Lingkungan Python
Pastikan Python telah terpasang di komputer. Selain itu, kita akan menggunakan pustaka requests untuk mengirim HTTP request ke GitHub API. Jika belum terpasang, jalankan perintah berikut di terminal atau command prompt:

pip install requests

Buat sebuah file Python baru, misalnya github_api.py, yang akan digunakan untuk menguji koneksi ke GitHub API.

Mengambil Data Repositori Publik
Contoh pertama adalah mengambil daftar repositori publik dari pengguna tertentu.

import requests

def get_repos(username):
    url = f"https://api.github.com/users/{username}/repos"
    response = requests.get(url)
    if response.status_code == 200:
        return response.json()
    else:
        return None

repos = get_repos("octocat")
if repos:
    for repo in repos:
        print(f"Nama Repo: {repo['name']} - URL: {repo['html_url']}")
else:
    print("Gagal mengambil data.")

Kode di atas memanfaatkan fungsi requests.get untuk mengakses endpoint API GitHub. Jika status kode 200, berarti permintaan berhasil dan data akan dikembalikan dalam format JSON.

Menambahkan Autentikasi Token
Jika ingin mengakses data pribadi atau menghindari batasan permintaan, kita perlu menambahkan token autentikasi. Token ini disimpan dengan aman, sebaiknya tidak ditulis langsung di dalam kode.

import os

def get_repos_with_token(username, token):
    url = f"https://api.github.com/users/{username}/repos"
    headers = {"Authorization": f"token {token}"}
    response = requests.get(url, headers=headers)
    return response.json()

token = os.getenv("GITHUB_TOKEN")
repos = get_repos_with_token("octocat", token)

Dengan metode ini, token dapat disimpan di environment variable sehingga tidak terekspos di file kode.

Mengolah Data API
Data yang diperoleh dari API GitHub biasanya berupa JSON dengan struktur yang cukup kompleks. Python menyediakan dukungan bawaan untuk memproses JSON sehingga kita dapat mengekstrak informasi yang dibutuhkan. Misalnya, kita bisa menampilkan hanya nama repo dan jumlah bintang (stars).

for repo in repos:
    print(f"{repo['name']} - Stars: {repo['stargazers_count']}")

Penanganan Error
Saat berinteraksi dengan API, penting untuk menangani kemungkinan error seperti koneksi gagal atau respons tidak sesuai. Gunakan try...except untuk memastikan aplikasi tidak berhenti mendadak.

try:
    repos = get_repos("octocat")
    if repos:
        print("Data berhasil diambil.")
except Exception as e:
    print(f"Terjadi kesalahan: {e}")

Menghubungkan Python dengan GitHub API adalah keterampilan yang sangat berguna bagi pengembang yang ingin mengotomatisasi pengambilan data atau membangun aplikasi yang memanfaatkan informasi dari GitHub. Dengan memanfaatkan pustaka requests dan konsep dasar HTTP request, kita dapat mengambil dan memproses data dengan mudah.

Panduan ini adalah langkah awal untuk memahami integrasi Python dengan API. Ke depannya, Anda bisa mengembangkan aplikasi yang lebih kompleks, seperti membuat dashboard analitik repositori atau mengotomatisasi laporan aktivitas proyek.