API (Application Programming Interface)

API hosting adalah cara Anda meminta server melakukan sesuatu lewat program, bukan lewat klik di panel. Satu sisi mengirim request, sisi lain menjawab dengan response, biasanya JSON. Tidak ada layar dan tidak ada tombol, hanya HTTP biasa yang membawa kredensial.

Bentuk sebuah request

Request yang benar punya empat bagian: endpoint, method, header autentikasi, dan untuk POST atau PUT sebuah body. Endpoint adalah URL seperti https://api.provider.com/v1/domains. Method menentukan aksinya: GET membaca, POST membuat, PATCH mengubah sebagian, DELETE menghapus. Kredensial masuk lewat header Authorization, bukan lewat query string.

curl -i "https://api.provider.com/v1/domains" \
  -H "Authorization: Bearer $API_TOKEN" \
  -H "Content-Type: application/json"

Flag -i membuat curl menampilkan header respons, bukan hanya badan JSON, sehingga status dan batas rate limit ikut terlihat. Content-Type memberi tahu server format data yang Anda kirim. Kalau dokumentasi menyediakan contoh, salin dulu satu request lengkap lalu ubah parameternya, daripada menulis ulang dari nol.

Status dan header yang dibaca

Sisi sukses memakai 200 untuk hasil baca, 201 untuk resource baru, dan 204 saat tidak ada isi. Sisi gagal: 400 berarti payload salah bentuk, 401 token tidak dikenali, 403 token valid tapi tidak berhak, 404 objek tidak ditemukan, 429 terlalu sering, dan 5xx masalah di server tujuan. Rate limit muncul di header, bukan di badan: cari X-RateLimit-Limit, X-RateLimit-Remaining, dan X-RateLimit-Reset. Kalau Remaining tinggal 0, tunggu sampai waktu reset daripada menembak ulang, sebab IP Anda bisa ikut diblokir.

Di mana API dipakai

API berguna saat pekerjaan berulang. Membuat DNS untuk banyak subdomain, menarik status SMTP, atau menyiapkan akun email lebih cepat lewat script daripada lewat cPanel. Deploy juga lewat API: satu push memicu rebuild. Kalau API yang dipanggil adalah endpoint Anda sendiri, setiap request memakan CPU dan kadang entry processes. Bila yang memanggil adalah browser, batasnya diatur CORS, bukan hanya token.

Yang perlu diwaspadai

Dua hal menipu. Pertama, 200 tidak selalu berarti sukses: banyak API mengembalikan status itu dengan body berisi error, jadi baca badan JSON, jangan berhenti di kode status. Kedua, respons bisa datang dari cache CDN, bukan dari origin. Kalau Anda mengubah data lalu memanggil endpoint yang sama dan nilainya masih lama, yang menjawab masih edge, bukan server sumber.

FAQ

API di konteks hosting biasanya berarti endpoint untuk beli domain, buat VPS, atau baca metrik. Provider cloud hosting dan VPS Hosting yang punya API memudahkan otomasi. Jangan simpan token di document root; itu kesalahan klasik bersama file .htaccess yang salah izin.