کلید API
کلید API رشتهٔ تصادفی بلندی است که سرویس با آن میفهمد درخواست از کیست: حساب چه کسی است، در کدام پلن است و چه دادهای میتواند بگیرد. برای برنامه کلید مثل رمز عبور عمل میکند: هر که رشته را بداند به نام صاحبش عمل میکند.
کلید چگونه فرستاده میشود
کلید در هدر هر درخواست میرود و فیلترها در آدرس. در Genesis API هدر X-API-Key است و کلید شکل gns_live_… دارد. مثال از سیگنالهای AI سیگنالهای درجهبندیشدهٔ alpha را میخواهد:
import os
import requests
key = os.environ.get("GENESIS_API_KEY")
if not key:
raise SystemExit("GENESIS_API_KEY را روی سرور تنظیم کنید")
r = requests.get(
"https://api.genesisarbitrage.com/v1/ai/signals",
headers={"X-API-Key": key}, # کلید فقط در هدر
params={"category": "alpha"}, # فیلترها در آدرس
timeout=10,
)
if r.status_code == 401:
# کلید نیست، نامعتبر است یا باطل شده
print(r.json()["error"]["code"]) # invalid_key
elif r.ok:
print("سیگنالهای alpha:", r.json()["meta"]["count"])
از هدر استفاده میشود چون آدرس درخواست، همراه query string، در لاگ وبسرور و پروکسی میماند و اگر کسی آن را در مرورگر باز کند در تاریخچهٔ مرورگر هم. مستندات Genesis API صریح میگوید: کلید را در پارامترهای آدرس نفرستید، در کد وبسایت یا اپلیکیشن نگذارید و درخواستها را فقط از سرور خودتان بزنید. صرافیها هم همینطور کار میکنند: Binance کلید را در هدر X-MBX-APIKEY میگیرد و درخواستهای حساب را با کلید دوم، یعنی API secret، امضا هم میکند.
کلید را چگونه نگه دارید
- کلید را در متغیر محیطی یا فایل
.envروی سرور نگه دارید و.envرا به.gitignoreاضافه کنید. - کلید را هرگز در کد وبسایت، اپلیکیشن موبایل، چت یا اسکرینشات نگذارید.
- Genesis API کلید را یک بار نشان میدهد و فقط هش آن را نگه میدارد: کلید گمشده بازیابی نمیشود و فقط دوباره صادر میشود.
- اگر کلید نشت کرد، در پروفایل «صدور مجدد» را بزنید تا کلید قبلی بیدرنگ از کار بیفتد. «ابطال» کلید را بدون جایگزین خاموش میکند.
کلید صرافی در برابر کلید Genesis API
| کلید صرافی | کلید Genesis API | |
|---|---|---|
| دسترسی | خواندن، معامله، برداشت: هر چه فعال کنید | فقط خواندن داده |
| نشت چه را آشکار میکند | معاملات و برداشتهای حساب شما | سهمیهٔ درخواستهای شما |
| محافظت | بدون برداشت، لیست سفید IP | صدور مجدد در پروفایل |
کلید Genesis API فقط خواندنی است: نه سفارش میگذارد و نه پول برداشت میکند. خطاهای کلید و کدهایشان در بخشهای احراز هویت و خطاها آمدهاند.
همچنین ببینید: API، endpoint، rate limit، کلید API: دریافت، نگهداری، صدور مجدد و ابطال.
پرسش و پاسخ
میتوانم چند کلید Genesis API بسازم؟
نه، هر حساب یک کلید دارد. «صدور مجدد» کلید تازه میدهد و کلید قبلی را بیدرنگ از کار میاندازد.
کلید Genesis API را از کجا بگیرم؟
در پروفایل، در بخش «Genesis API»، پس از پرداخت پلن API. دکمهٔ «دریافت کلید» پنجرهٔ «کلید API شما» را با دکمهٔ «کپی» باز میکند.