مفاتيح الإدارة — SaaS على Gonka

هل أنت مطور SaaS وترغب في تقديم خدمة AI-inference لعملائك بدون بنية تحتية خاصة بك؟ تتيح لك مفاتيح الإدارة إنشاء مفاتيح API هرمية: مفتاح رئيسي واحد يدير العديد من مفاتيح العملاء بحدود فردية ومدة صلاحية محددة. تحت الغطاء — JoinGonka Gateway وشبكة Gonka.

ما هي مفاتيح الإدارة؟

مفاتيح الإدارة هي نظام مفاتيح API هرمي لبناء منتجات SaaS فوق Gonka AI Gateway.

البنية ذات مستويين:

مفتاح الإدارة (gm-) — مفتاحك الرئيسي. لا يستخدم للاستنتاج مباشرة — فقط لإنشاء وإدارة المفاتيح الفرعية.
المفتاح الفرعي (gc-) — مفتاح لعميلك. يستخدم لطلبات الاستنتاج. يتم خصم الفواتير من رصيد مالك مفتاح الإدارة.

هذا نموذج ذو علامة بيضاء: يعمل عملاؤك من خلال مفاتيح gc- الخاصة بهم ولا يعرفون عن Gonka — بالنسبة لهم هذا هو خدمتك.

لماذا هذا ضروري؟

بدون مفاتيح الإدارة، كنت ستمنح مفتاح API واحدًا لجميع العملاء - بدون التحكم في التكاليف، بدون عزل، بدون تحليلات. تحل مفاتيح الإدارة 4 مهام:

المهمة	كيف تحلها
التحكم في التكاليف	حد يومي وشهري بالـ GNK لكل مفتاح فرعي
وصول مؤقت	TTL (expires_at) - يتم إلغاء تنشيط المفتاح تلقائيًا
عزل العملاء	كل عميل لديه مفتاح gc- خاص به ومعدل حد
فوترة موحدة	جميع المفاتيح الفرعية تخصم من رصيدك - فاتورة واحدة

كيفية إنشاء مفتاح إدارة

الخطوة 1: سجل في gate.joingonka.ai وقم بتمويل رصيدك بـ GNK أو USDT.

الخطوة 2: أنشئ مفتاح إدارة عبر API:

curl -X POST https://gate.joingonka.ai/api/management/keys \
  -H "Authorization: Bearer YOUR_JWT" \
  -H "Content-Type: application/json" \
  -d '{"name": "My SaaS"}'

تحتوي الاستجابة على مفتاح عادي (بادئة gm-) — احفظه، يتم عرضه مرة واحدة فقط.

الخطوة 3: أنشئ مفتاحًا فرعيًا للعميل:

curl -X POST https://gate.joingonka.ai/api/management/keys/{gm_key_id}/children \
  -H "Authorization: Bearer YOUR_JWT" \
  -H "Content-Type: application/json" \
  -d '{"name": "Client A", "limit_daily_ngonka": "1000000000", "rate_limit_rpm": 30}'

يتلقى العميل A مفتاح gc- بحد 1 GNK/يوم و 30 طلبًا/دقيقة.

الحدود و TTL

كل مفتاح فرعي يدعم ثلاثة أنواع من القيود:

الحد اليومي (limit_daily_ngonka) — أقصى إنفاق خلال يوم UTC. يتم إعادة تعيينه تلقائيًا في منتصف الليل بتوقيت UTC.
الحد الشهري (limit_monthly_ngonka) — أقصى إنفاق خلال شهر تقويمي.
مهلة الصلاحية TTL (expires_at) — تاريخ/وقت انتهاء صلاحية المفتاح. بعد هذا الوقت، يتوقف المفتاح عن المصادقة.

عند تجاوز الحد اليومي أو الشهري، يتلقى العميل رمز HTTP 402 مع التفاصيل:

{"error": {"type": "child_key_limit", "daily_remaining": "0", "monthly_remaining": "500000000"}}

جميع الحدود اختيارية — إذا لم يتم تحديدها، فإن المفتاح يقتصر فقط على رصيد المالك.

إدارة المفاتيح الفرعية

إنشاء، قراءة، تحديث، حذف كاملة عبر API:

العملية	نقطة النهاية	الوصف
إنشاء	POST /api/management/keys/:id/children	مفتاح gc- جديد بحدود
قائمة	GET /api/management/keys/:id/children	جميع المفاتيح الفرعية مع الاستخدام
تحديث	PATCH /api/management/keys/:id/children/:childId	تغيير الحدود، RPM، الحالة
حذف	DELETE /api/management/keys/:id/children/:childId	إلغاء تنشيط ناعم

الإدارة متاحة أيضًا عبر لوحة التحكم: قسم مفاتيح API ← مفاتيح الإدارة.

مقارنة مع المنافسين

الميزة	JoinGonka	OpenRouter
Management keys	gm- / gc-	لا
الحدود اليومية/الشهرية	GNK (nGNK)	—
TTL (وقت انتهاء الصلاحية)	expires_at	—
Dashboard UI	نعم (قسم Keys)	—
الإحالات	10% L1 + 3% L2	لا
سعر الـ inference	$0.003 / $0.009 لكل 1M	$0.08+/1M

توفر JoinGonka حدود GNK، وTTL، وDashboard UI لمفاتيح الإدارة — فوق شبكة Gonka inference الرخيصة.

مفاتيح الإدارة تحوّل JoinGonka Gateway إلى منصة ذات علامة بيضاء. مفتاح إدارة واحد → عدد غير محدود من المفاتيح الفرعية بحدود فردية. يتلقى عملاؤك AI-inference، وتتحكم أنت في التكاليف وتحقق ربحًا من الهامش.

← JoinGonka Gateway - مراجعة كاملة أرخص واجهة برمجة تطبيقات AI: مقارنة المزودين 2026 →

تريد معرفة المزيد؟

استكشف الأقسام الأخرى أو ابدأ في كسب GNK الآن.

احصل على 10 مليون توكن مجاني →