Genesis Arbitrage

Genesis Arbitrage · · 2 دقائق قراءة

مفتاح 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"])

تُستخدم الترويسة لأن رابط الطلب، بما فيه سلسلة الاستعلام، يظهر في سجلات خادم الويب والوكيل، وفي سجل المتصفح إذا فتحه أحدهم في المتصفح. ويقولها توثيق Genesis API صراحةً: لا تمرر المفتاح في معاملات الرابط، ولا تضمّنه في كود موقع أو تطبيق، وأرسل الطلبات من خادمك فقط. البورصات تعمل بالطريقة نفسها: تأخذ Binance المفتاح في الترويسة X-MBX-APIKEY، وتُوقَّع طلبات الحساب أيضًا بمفتاح ثانٍ هو API secret.

كيف تحفظ المفتاح

مفتاح البورصة مقابل مفتاح Genesis API

مفتاح البورصةمفتاح Genesis API
الصلاحياتقراءة وتداول وسحب: حسب ما تفعّلهقراءة البيانات فقط
التسرب يكشفالصفقات وعمليات السحب في حسابكحصتك من الاستدعاءات
الحمايةمنع السحب وقائمة IP بيضاءإعادة الإصدار من ملفك الشخصي

مفتاح Genesis API للقراءة فقط: لا يضع أوامر ولا يسحب أموالًا. أخطاء المفتاح وأكوادها في قسمي المصادقة والأخطاء.

انظر أيضًا: API، نقطة النهاية، حد المعدل، مفتاح API: الحصول عليه وحفظه وإعادة إصداره وإلغاؤه.

أسئلة وأجوبة

هل يمكنني إنشاء عدة مفاتيح Genesis API؟

لا، للحساب مفتاح واحد. «إعادة الإصدار» تعطيك مفتاحًا جديدًا وتعطّل القديم فورًا.

من أين أحصل على مفتاح Genesis API؟

من ملفك الشخصي، في كتلة «Genesis API»، بعد دفع خطة API. يفتح الزر «الحصول على مفتاح» نافذة «مفتاح API الخاص بك» وفيها زر «نسخ».