API key
API key adalah string acak panjang yang dipakai sebuah layanan untuk mengetahui siapa pengirim request: akun siapa, paket apa, dan data apa yang boleh diterima. Bagi program, key bekerja seperti password: siapa pun yang tahu string-nya bertindak atas nama pemiliknya.
Cara key dikirim
Key dikirim di header setiap request, sedangkan filter ditaruh di URL. Di Genesis API headernya adalah X-API-Key dan key berbentuk gns_live_…. Contoh berikut meminta sinyal AI Signals dengan grade alpha:
import os
import requests
key = os.environ.get("GENESIS_API_KEY")
if not key:
raise SystemExit("set GENESIS_API_KEY on the server")
r = requests.get(
"https://api.genesisarbitrage.com/v1/ai/signals",
headers={"X-API-Key": key}, # key hanya dikirim lewat header
params={"category": "alpha"}, # filter dikirim lewat URL
timeout=10,
)
if r.status_code == 401:
# key tidak ada, tidak valid, atau sudah dicabut
print(r.json()["error"]["code"]) # invalid_key
elif r.ok:
print("alpha signals:", r.json()["meta"]["count"])
Header dipakai karena URL request, termasuk query string, masuk ke log web server dan proxy, juga ke riwayat browser jika seseorang membukanya di browser. Dokumentasi Genesis API menyatakannya dengan jelas: jangan pernah mengirim key lewat parameter query, jangan menyematkannya di kode website atau aplikasi, dan buat request hanya dari server Anda sendiri. Exchange bekerja serupa: Binance menerima key di header X-MBX-APIKEY, dan request akun juga ditandatangani dengan key kedua, yaitu API secret.
Cara menyimpan key
- Simpan key di environment variable atau file
.envdi server, dan tambahkan.envke.gitignore. - Jangan pernah menempelkan key ke kode website, aplikasi mobile, chat, atau screenshot.
- Genesis API menampilkan key sekali dan hanya menyimpan hash-nya: key yang hilang tidak bisa dipulihkan, hanya diterbitkan ulang.
- Jika key bocor, klik "Buat ulang" di profil Anda dan key lama langsung berhenti bekerja. "Cabut" menonaktifkan key tanpa pengganti.
Key exchange vs key Genesis API
| Key exchange | Key Genesis API | |
|---|---|---|
| Hak akses | Baca, trading, penarikan: apa pun yang Anda aktifkan | Hanya baca data |
| Jika bocor | Transaksi dan penarikan di akun Anda | Kuota panggilan Anda |
| Perlindungan | Tanpa penarikan, whitelist IP | Buat ulang di profil Anda |
Key Genesis API bersifat hanya-baca: tidak bisa menempatkan order atau menarik dana. Error key dan kodenya ada di bagian Autentikasi dan Error.
Lihat juga: API, endpoint, rate limit, API key: cara mendapatkan, menyimpan, menerbitkan ulang, dan mencabut.
Tanya jawab
Bisakah saya membuat beberapa key Genesis API?
Tidak, satu akun memiliki satu key. "Buat ulang" memberi Anda key baru dan langsung menonaktifkan yang lama.
Di mana saya mendapatkan key Genesis API?
Di profil Anda, pada blok Genesis API, setelah Anda membayar paket API. Tombol "Dapatkan key" membuka jendela "API key Anda" dengan tombol "Salin".