Panggil Alphagate, bayar lebih sedikit.

Gateway ini pengganti langsung untuk API Alphagate. Path, query, dan bentuk respons persis sama — yang berubah cuma host dan isi header x-api-key.

Mulai

Kamu butuh satu client key dari operator gateway, bentuknya agk_…. Itu bukan kunci Alphagate: kunci yang asli tidak pernah keluar dari server gateway dan kamu tidak akan pernah melihatnya. Kalau key-mu bocor, operator bisa mencabutnya tanpa mengganggu pemakai lain.

# sebelumnya
curl "https://api.alphagate.io/api/v2/user/alpha?username=elonmusk" \
  -H "x-api-key: KUNCI_ALPHAGATE"

# lewat gateway
curl "$GATEWAY/api/v2/user/alpha?username=elonmusk" \
  -H "x-api-key: agk_45a18cd75a7a1e83…"

const res = await fetch(
  `${GATEWAY}/api/v2/user/alpha?username=${encodeURIComponent(name)}`,
  { headers: { 'x-api-key': process.env.GATEWAY_KEY } },
)
const { data } = await res.json()

Tiap respons menjelaskan dirinya

x-cache: hit            hit | miss | stale | bypass | error
x-cache-age: 1841       detik sejak data ini diambil dari Alphagate
x-credits-charged: 0    credit yang terpotong untuk permintaan ini
x-credits-saved: 6      credit yang tidak jadi terpotong karena cache

Beda dari memanggil Alphagate langsung

Bentuk error tetap sama seperti Alphagate, {"message":"…"}, termasuk 401 dan 502 yang berasal dari gateway sendiri. Dua pengecualian yang bodinya kosong:404 untuk path di luar /api/v2/ dan 405 untuk metode selain GET — keduanya salah alamat, bukan jawaban API.

Yang perlu diketahui

Butuh data terbaru? Tambahkan _fresh=1. Cache dilewati, credit terpotong, isi cache ikut diperbarui, dan parameter itu tidak diteruskan ke Alphagate. Jangan dijadikan kebiasaan — kalau semua permintaanmu memakainya, kamu membayar penuh seperti tanpa gateway.

Query yang beda tulisan tapi sama maksudnya dianggap satu. Urutan parameter tidak berpengaruh, username tidak peka huruf besar-kecil, dancount dianggap sama dengan limit pada endpoint yang menerima keduanya. Kamu tidak perlu menyeragamkan sendiri untuk mendapat hit.

404 ikut di-cache sebentar. Username yang tidak ada dijawab langsung tanpa memanggil Alphagate. Ini tidak memakan credit — Alphagate memang tidak menagih 404 — hanya menghemat waktu tunggu.

Kolom TTL di bawah adalah setelan gateway ini sekarang, bukan angka contoh. Operator bisa mengubahnya kapan saja, jadi jangan menanam asumsi umur data di kodemu; baca x-cache-age kalau kesegarannya penting bagimu.