Genesis Arbitrage

Genesis Arbitrage · · 3 دقیقه مطالعه

کلید 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، امضا هم می‌کند.

کلید را چگونه نگه دارید

کلید صرافی در برابر کلید Genesis API

کلید صرافیکلید Genesis API
دسترسیخواندن، معامله، برداشت: هر چه فعال کنیدفقط خواندن داده
نشت چه را آشکار می‌کندمعاملات و برداشت‌های حساب شماسهمیهٔ درخواست‌های شما
محافظتبدون برداشت، لیست سفید IPصدور مجدد در پروفایل

کلید Genesis API فقط خواندنی است: نه سفارش می‌گذارد و نه پول برداشت می‌کند. خطاهای کلید و کدهایشان در بخش‌های احراز هویت و خطاها آمده‌اند.

همچنین ببینید: API، endpoint، rate limit، کلید API: دریافت، نگهداری، صدور مجدد و ابطال.

پرسش و پاسخ

می‌توانم چند کلید Genesis API بسازم؟

نه، هر حساب یک کلید دارد. «صدور مجدد» کلید تازه می‌دهد و کلید قبلی را بی‌درنگ از کار می‌اندازد.

کلید Genesis API را از کجا بگیرم؟

در پروفایل، در بخش «Genesis API»، پس از پرداخت پلن API. دکمهٔ «دریافت کلید» پنجرهٔ «کلید API شما» را با دکمهٔ «کپی» باز می‌کند.