Genesis Arbitrage

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

مفتاح 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.

كيف تحصل على مفتاح

  1. اشترك في خطة API

    في صفحة أسعار Genesis API اختر Trial أو Start أو Pro أو Max ومدة الاشتراك، واضغط «اشتراك» وادفع الفاتورة بالعملات الرقمية. تتغير الحالة في ملفك الشخصي إلى «الاشتراك نشط».

  2. اضغط «الحصول على مفتاح»

    يظهر الزر في كتلة «Genesis API» ما دام لا يوجد لديك مفتاح. يُنشأ المفتاح فورًا.

  3. احفظ المفتاح من نافذة «مفتاح API الخاص بك»

    تعرض النافذة المفتاح كاملًا مرة واحدة. اضغط «نسخ» وضع المفتاح في مدير كلمات المرور أو مباشرة في المتغيرات المحمية على خادمك. بعد «تم» لن ترى المفتاح كاملًا مرة أخرى: نحتفظ بالبصمة فقط.

  4. اختبر المفتاح بطلب

    استدعِ /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.» مع «إلغاء» و«تأكيد». إذا تسرّب المفتاح:

  1. أعد إصدار المفتاح

    اضغط «إعادة الإصدار» ثم «تأكيد»، واحفظ المفتاح الجديد من نافذة «مفتاح API الخاص بك». ومنذ تلك اللحظة تحصل الطلبات بالمفتاح القديم على 401.

  2. استبدل المفتاح في كل برنامج

    حدّث متغيرات البيئة وملفات .env وأسرار CI والاستضافة، ثم أعد تشغيل البرامج: فالعملية تقرأ بيئتها عند البدء. إذا كان برنامج ما لا يزال يرسل المفتاح القديم، فتحقق هل GENESIS_API_KEY معيّن أصلًا في البيئة: python-dotenv وnode --env-file لا يستبدلان متغيرًا معيّنًا بالفعل بالقيمة من .env.

  3. افحص استهلاك الاستدعاءات

    يعرض سطر «الاستدعاءات المستخدمة» في ملفك الشخصي، أو طلب إلى /account/usage، عدد الاستدعاءات المنفقة في هذه الفترة. إعادة الإصدار لا تصفّر العداد.

401 invalid_key: ماذا تفحص

يرد الخادم بـ 401 مع الرمز invalid_key عندما يكون المفتاح غائبًا أو خاطئًا أو ملغى، أو انتهى الاشتراك:

{
  "success": false,
  "error": {
    "code": "invalid_key",
    "message": "Missing X-API-Key header."
  }
}

إذا وصلت الترويسة لكن رُفض المفتاح، فإن 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، وبعد «تجديد» يعمل المفتاح نفسه من جديد.