Yang perlu disiapkan
| Kebutuhan | Keterangan |
|---|---|
| Akun AIport dengan saldo | Daftar gratis, lalu isi saldo rupiah di dashboard. |
| API key | Dibuat di halaman API keys pada dashboard. |
| Backend | Server Node.js, PHP, Python, atau fungsi serverless. Hosting statis saja tidak cukup. |
| HTTPS | Agar data pengguna terenkripsi saat dikirim ke server-mu. |
Langkah integrasi
Buat API key
Buka Dashboard → API keys, lalu buat key baru. Key hanya ditampilkan sekali, jadi salin dan simpan saat itu juga.

Simpan di environment variable
Simpan sebagai AIPORT_API_KEY di server. Jangan menaruhnya di kode yang di-commit atau di file JavaScript publik.
Buat endpoint backend
Satu route, misalnya POST /api/ai, yang menerima input pengguna lalu memanggil AIport. Contoh kode untuk tiga bahasa ada di bawah.
Panggil dari halaman web
Frontend memanggil endpoint milikmu dengan fetch, lalu menampilkan jawabannya.

Kenapa API key tidak boleh ada di frontend
Semua yang dikirim ke browser bisa dilihat siapa pun lewat View Source atau DevTools. Kalau API key ada di JavaScript, orang lain bisa memakainya dan menghabiskan saldomu.
Kalau key terlanjur bocor, hapus key itu di Dashboard → API keys dan buat yang baru. Key yang dihapus langsung tidak bisa dipakai.

Kode backend dan frontend
Batasi panjang input (contoh di atas memotong di 2.000 karakter) dan tambahkan rate limit per pengguna di endpoint-mu agar biaya tidak membengkak.
Troubleshooting
| Gejala | Penyebab | Solusi |
|---|---|---|
HTTP 401 unauthorized | API key salah, terpotong, atau sudah dihapus | Cek environment variable dan buat key baru bila perlu |
HTTP 429 insufficient_quota | Saldo tidak cukup | Top up saldo di dashboard |
HTTP 429 too_many_inflight | Lebih dari 5 request berjalan bersamaan | Tunggu sebentar lalu ulangi, atau antrekan request |
| Error CORS di browser | Frontend memanggil AIport secara langsung | Panggil lewat endpoint backend milikmu |
HTTP 400 invalid_request | Nama field salah ketik atau nilai tidak valid | Bandingkan request dengan dokumentasi API |
Pertanyaan seputar cara integrasi AI ke website
Apakah AI bisa dipanggil langsung dari JavaScript di browser?
Jangan. API key akan terlihat oleh siapa pun yang membuka halaman. Panggil AIport dari backend, lalu frontend memanggil backend-mu.
Bahasa pemrograman apa yang bisa dipakai?
Bahasa apa pun yang bisa mengirim HTTP request: Node.js, PHP, Python, Go, Java, dan lainnya. Halaman ini memberi contoh untuk tiga yang paling umum.
Bagaimana kalau API key saya bocor?
Hapus key tersebut di Dashboard → API keys dan buat key baru. Key yang dihapus langsung berhenti berfungsi.
Apakah website dengan hosting statis bisa memakai AI?
Bisa, asalkan ada lapisan backend, misalnya fungsi serverless, yang menyimpan API key dan meneruskan request ke AIport.
Pasang AI di website-mu hari ini
Buat API key, salin contoh kode, dan jalankan endpoint pertamamu.
