مفتاح 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.
كيف تحفظ المفتاح
- احتفظ بالمفتاح في متغير بيئة أو ملف
.envعلى الخادم، وأضف.envإلى.gitignore. - لا تلصق المفتاح في كود موقع أو تطبيق جوال أو محادثة أو لقطة شاشة.
- يعرض Genesis API المفتاح مرة واحدة ويحفظ بصمته (hash) فقط: المفتاح المفقود لا يُستعاد بل يُعاد إصداره.
- إذا تسرّب المفتاح فاضغط «إعادة الإصدار» في ملفك الشخصي ويتوقف المفتاح القديم فورًا. «إلغاء المفتاح» يعطّل المفتاح دون بديل.
مفتاح البورصة مقابل مفتاح Genesis API
| مفتاح البورصة | مفتاح Genesis API | |
|---|---|---|
| الصلاحيات | قراءة وتداول وسحب: حسب ما تفعّله | قراءة البيانات فقط |
| التسرب يكشف | الصفقات وعمليات السحب في حسابك | حصتك من الاستدعاءات |
| الحماية | منع السحب وقائمة IP بيضاء | إعادة الإصدار من ملفك الشخصي |
مفتاح Genesis API للقراءة فقط: لا يضع أوامر ولا يسحب أموالًا. أخطاء المفتاح وأكوادها في قسمي المصادقة والأخطاء.
انظر أيضًا: API، نقطة النهاية، حد المعدل، مفتاح API: الحصول عليه وحفظه وإعادة إصداره وإلغاؤه.
أسئلة وأجوبة
هل يمكنني إنشاء عدة مفاتيح Genesis API؟
لا، للحساب مفتاح واحد. «إعادة الإصدار» تعطيك مفتاحًا جديدًا وتعطّل القديم فورًا.
من أين أحصل على مفتاح Genesis API؟
من ملفك الشخصي، في كتلة «Genesis API»، بعد دفع خطة API. يفتح الزر «الحصول على مفتاح» نافذة «مفتاح API الخاص بك» وفيها زر «نسخ».