مفتاح Genesis API: كيف تحصل عليه وأين تخزنه وكيف تعيد إصداره وتلغيه
باختصار
- يُنشأ مفتاح
gns_live_…في ملفك الشخصي بزر «الحصول على مفتاح» ويظهر مرة واحدة فقط. نحتفظ بالبصمة (hash) فقط، لذلك لا يمكن استرجاع المفتاح المفقود، بل إعادة إصداره. - يُرسل المفتاح في الترويسة
X-API-Keyمن خادمك أنت. يقرأ الكود المفتاح من متغير البيئةGENESIS_API_KEY، ولا يوضع أبدًا في رابط الطلب ولا في كود موقع. - إذا تسرّب المفتاح فاضغط «إعادة الإصدار»: يتوقف المفتاح القديم فورًا، وتستبدله في كل برنامج. لكل حساب مفتاح واحد.
مفتاح API لـ Genesis API هو سلسلة gns_live_… تعمل مثل كلمة المرور: يتعرف الخادم بها على حسابك وخطتك. ترسله مع كل طلب في ترويسة HTTP باسم X-API-Key؛ وبدون مفتاح أو بمفتاح خاطئ يعيد API الخطأ 401 invalid_key. لكل حساب مفتاح واحد، وتحصل عليه وتعيد إصداره وتلغيه من ملفك الشخصي في Genesis Arbitrage.
أين يوجد المفتاح
تدير المفتاح من ملفك الشخصي، في كتلة «Genesis API»؛ أما بقية كتل الملف الشخصي فيشرحها دليل الملف الشخصي للحساب. تعرض الكتلة اشتراك API وحالة المفتاح:
| ما تراه | ما معناه |
|---|---|
| «الاشتراك غير نشط»، زر «اشتراك» | لا توجد خطة API بعد؛ يفتح الزر صفحة الخطط |
| «الاشتراك نشط»، «نشط حتى …»، زر «تجديد» | الخطة سارية حتى هذا التاريخ |
| «انتهى الاشتراك»، زر «تجديد» | انتهت المدة: يُرفض المفتاح وتختفي أزرار المفتاح حتى تجدد |
| «لم يُنشأ مفتاح بعد»، زر «الحصول على مفتاح» | لديك خطة لكن لا مفتاح بعد |
«مفتاح API» وgns_live_… | بداية المفتاح النشط؛ لا يظهر المفتاح كاملًا مرة أخرى |
| «أُنشئ …» · «استُخدم …» | وقت إنشاء المفتاح ووقت آخر طلب أجراه |
| «الاستدعاءات المستخدمة»، «req/s»، «freshness»، «يُعاد التعيين …» | الحصة المستهلكة، وحد الطلبات في الثانية، وتأخر البيانات، وتاريخ تصفير العداد |
يفتح رابط «التوثيق» في زاوية الكتلة توثيق Genesis API. تجد شرح الحصة والحدود في دليل حدود Genesis API.
كيف تحصل على مفتاح
اشترك في خطة API
في صفحة أسعار Genesis API اختر Trial أو Start أو Pro أو Max ومدة الاشتراك، واضغط «اشتراك» وادفع الفاتورة بالعملات الرقمية. تتغير الحالة في ملفك الشخصي إلى «الاشتراك نشط».
اضغط «الحصول على مفتاح»
يظهر الزر في كتلة «Genesis API» ما دام لا يوجد لديك مفتاح. يُنشأ المفتاح فورًا.
احفظ المفتاح من نافذة «مفتاح API الخاص بك»
تعرض النافذة المفتاح كاملًا مرة واحدة. اضغط «نسخ» وضع المفتاح في مدير كلمات المرور أو مباشرة في المتغيرات المحمية على خادمك. بعد «تم» لن ترى المفتاح كاملًا مرة أخرى: نحتفظ بالبصمة فقط.
اختبر المفتاح بطلب
استدعِ
/account/usageكما في الأمثلة أدناه. الاستجابة200مع خطتك فيdata.planتعني أن المفتاح مقبول.
كيف ترسل المفتاح
يوضع المفتاح في الترويسة X-API-Key فقط. لا يقرأ الخادم المفتاح من معاملات الرابط ولا من الترويسة Authorization، ويرد بـ 401. تقرأ الأمثلة المفتاح من متغير البيئة GENESIS_API_KEY؛ والرابط الأساسي هو https://api.genesisarbitrage.com/v1.
curl:
# the key comes from an environment variable
curl "https://api.genesisarbitrage.com/v1/account/usage" \
-H "X-API-Key: $GENESIS_API_KEY"
Python 3.10+ مع مكتبة requests:
import os
import requests
# os.environ[...] fails right away if the variable is not set
key = os.environ["GENESIS_API_KEY"]
r = requests.get(
"https://api.genesisarbitrage.com/v1/account/usage",
headers={"X-API-Key": key},
timeout=10,
)
r.raise_for_status()
print(r.json()["data"]["plan"])
JavaScript، Node.js 18+ مع fetch المدمجة:
// .mjs file: modules allow top-level await
const key = process.env.GENESIS_API_KEY;
if (!key) throw new Error('GENESIS_API_KEY is not set');
const res = await fetch(
'https://api.genesisarbitrage.com/v1/account/usage',
{ headers: { 'X-API-Key': key } },
);
const body = await res.json();
console.log(res.status, body.data?.plan);
تعيد الطلبات الثلاثة الاستجابة نفسها (قيم توضيحية):
{
"success": true,
"data": {
"plan": "pro",
"calls_used": 184201,
"calls_limit": 5000000,
"rps_limit": 5,
"freshness_sec": 10,
"period_resets_at": 1786492800
},
"meta": { … }
}
حقول الاستجابة موصوفة في قسم الاستخدام من التوثيق.
أين تخزن المفتاح
مفتاح Genesis API يقرأ البيانات فقط: لا يمكنك به التداول ولا سحب الأموال. لكن تسرّبه يكلّفك شيئًا آخر: برامج غيرك تستهلك حصتك وحد الطلبات في الثانية.
| المكان | مناسب | السبب |
|---|---|---|
| متغير بيئة على الخادم | نعم | يبقى المفتاح خارج الكود والمستودع |
ملف .env مدرج في .gitignore | نعم | يحمّله python-dotenv (load_dotenv()) وnode --env-file=.env في Node.js 20.6+ |
| أسرار الاستضافة وCI | نعم | تسلّم المنصة المفتاح للبرنامج عند التشغيل؛ في GitHub Actions سرّ مستودع يُمرَّر عبر env الخطوة |
| مدير كلمات المرور | نعم | نسخة احتياطية للإنسان |
| رابط الطلب | لا | تنتهي الروابط في سجلات الخادم والبروكسي وفي سجل المتصفح |
| كود موقع أو إضافة أو تطبيق جوال | لا | يرى المفتاح كل من يفتح مصدر الصفحة أو يفك حزمة التطبيق |
| مستودع عام | لا | يبقى المفتاح في سجل الـ commits حتى بعد حذف الملف |
| لقطات الشاشة والمحادثات وتذاكر الدعم | لا | تُعاد الرسائل والصور إلى آخرين |
إذا كان على البيانات أن تصل إلى المتصفح، مثل لوحة معلومات أو إضافة، فيستدعي خادمك Genesis API ويستلم المتصفح النتيجة الجاهزة من خادمك. يحتاج الدعم إلى X-Request-Id من الاستجابة ووقت الطلب بتوقيت UTC والـ endpoint والحالة، وليس المفتاح أبدًا. مفاتيح البورصات ذات صلاحيات التداول أخطر؛ وطريقة تقييدها في كيف تؤمّن حساب بورصة العملات الرقمية.
إعادة الإصدار والإلغاء
| الزر | ما يحدث | متى تستخدمه |
|---|---|---|
| «إعادة الإصدار» | يتوقف المفتاح القديم فورًا، وتعرض نافذة «مفتاح API الخاص بك» مفتاحًا جديدًا | تسرّب المفتاح أو فُقد، أو غادر شخص كان يملكه |
| «إلغاء المفتاح» | يُوقف المفتاح دون بديل ويُغلق الوصول إلى API؛ وتعرض الكتلة «الحصول على مفتاح» من جديد | لم تعد بحاجة إلى المفتاح |
يطلب الزران تأكيدًا أولًا. نص النافذتين: «إعادة إصدار المفتاح؟ المفتاح الحالي سيتوقف فورًا.» و«إلغاء المفتاح؟ سيتوقف فورًا ويُغلق الوصول إلى API.» مع «إلغاء» و«تأكيد». إذا تسرّب المفتاح:
أعد إصدار المفتاح
اضغط «إعادة الإصدار» ثم «تأكيد»، واحفظ المفتاح الجديد من نافذة «مفتاح API الخاص بك». ومنذ تلك اللحظة تحصل الطلبات بالمفتاح القديم على
401.استبدل المفتاح في كل برنامج
حدّث متغيرات البيئة وملفات
.envوأسرار CI والاستضافة، ثم أعد تشغيل البرامج: فالعملية تقرأ بيئتها عند البدء. إذا كان برنامج ما لا يزال يرسل المفتاح القديم، فتحقق هلGENESIS_API_KEYمعيّن أصلًا في البيئة: python-dotenv وnode --env-fileلا يستبدلان متغيرًا معيّنًا بالفعل بالقيمة من.env.افحص استهلاك الاستدعاءات
يعرض سطر «الاستدعاءات المستخدمة» في ملفك الشخصي، أو طلب إلى
/account/usage، عدد الاستدعاءات المنفقة في هذه الفترة. إعادة الإصدار لا تصفّر العداد.
401 invalid_key: ماذا تفحص
يرد الخادم بـ 401 مع الرمز invalid_key عندما يكون المفتاح غائبًا أو خاطئًا أو ملغى، أو انتهى الاشتراك:
{
"success": false,
"error": {
"code": "invalid_key",
"message": "Missing X-API-Key header."
}
}
- لم تصل الترويسة. «Missing X-API-Key header.» تعني أن الطلب لم يحمل مفتاحًا إطلاقًا. افحص اسم الترويسة وهل المتغير معيّن في المكان الذي يعمل فيه البرنامج: على الخادم، أو في الحاوية، أو في المهمة المجدولة.
- المفتاح مشوّه. مسافة زائدة أو علامات اقتباس داخل القيمة أو نهاية مقطوعة تعطي
401: يجب أن يطابق المفتاح حرفًا بحرف. - أُعيد إصدار المفتاح أو أُلغي. قارن بداية المفتاح في برنامجك ببداية المفتاح التي يعرضها ملفك الشخصي تحت «مفتاح API».
- انتهى الاشتراك. يعرض ملفك الشخصي «انتهى الاشتراك». بعد «تجديد» يعمل المفتاح نفسه من جديد دون حاجة إلى إعادة إصداره.
إذا وصلت الترويسة لكن رُفض المفتاح، فإن message يسرد كل الأسباب الممكنة دفعة واحدة. أما الاستجابة 403 plan_restricted فتعني شيئًا آخر: المفتاح مقبول لكن الـ endpoint ليس ضمن خطتك. الرموز الأخرى في قسم الأخطاء وفي دليل استجابات Genesis API وأخطاؤه.
نموذج «جرّب» في التوثيق
لكل endpoint في التوثيق نموذج «جرّب». الصق المفتاح في حقل «مفتاح API الخاص بك (gns_live_…)» واضغط «إرسال الطلب»: يظهر تحت النموذج رمز الحالة ووقت الاستجابة واستجابة مختصرة. يُحفظ المفتاح في متصفحك فقط ولا يُرسل إلى أي مكان سوى API.
يتذكر المتصفح المفتاح ويملأ الحقل في زيارتك التالية، فلا تستخدم النموذج على حاسوب شخص آخر. الطلب من النموذج استدعاء API عادي: يستهلك الحصة وحد الطلبات في الثانية مثل طلب من الكود. طلبك الأول من الكود مع شرح الاستجابة في البداية السريعة مع Genesis API.
أسئلة وأجوبة
هل يمكن أن يكون لكل بوت مفتاح منفصل؟
لا، لكل حساب مفتاح واحد. وتتشارك كل البرامج التي تستخدمه حصة الاستدعاءات وحد الطلبات في الثانية. إذا كانت الحدود ضيقة فارفع خطتك: فتح عدة حسابات للالتفاف على الحدود يخالف القواعد.
هل تصفّر إعادة الإصدار عدّاد الاستدعاءات؟
لا. «الاستدعاءات المستخدمة» تتبع اشتراك الحساب لا المفتاح: يواصل المفتاح الجديد الفترة نفسها البالغة 30 يومًا.
هل يمكن كتابة الترويسة بأحرف صغيرة x-api-key؟
نعم. أسماء ترويسات HTTP لا تتأثر بحالة الأحرف، وهي قاعدة نصّ عليها RFC 9110، القسم 5.1. أما المفتاح نفسه فيجب إرساله دون تغيير.
هل أحتاج إلى مفتاح جديد بعد التجديد؟
لا. ما دام الاشتراك منتهيًا يحصل المفتاح على 401، وبعد «تجديد» يعمل المفتاح نفسه من جديد.