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

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

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

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

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

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

الخطوة 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 طلبًا/دقيقة.

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

• الحد اليومي (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:

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

JoinGonka — هو بوابة Gonka الوحيدة التي تحتوي على حدود GNK و TTL وواجهة مستخدم لوحة التحكم لمفاتيح الإدارة.