مینجمنٹ کیز — Gonka پر SaaS

مینجمنٹ کیز — Gonka AI Gateway پر SaaS پروڈکٹس بنانے کے لیے ہیرارکیکل API کیز کا ایک نظام ہے۔

آرکیٹیکچر دو سطحی ہے:

• مینجمنٹ کی (gm-) — آپ کی ماسٹر-کی۔ اسے براہ راست انفرنس کے لیے استعمال نہیں کیا جاتا — صرف چائلڈ کیز بنانے اور ان کا انتظام کرنے کے لیے۔
• چائلڈ کی (gc-) — آپ کے کلائنٹ کے لیے کی. اسے انفرنس-ریکویسٹس کے لیے استعمال کیا جاتا ہے۔ بلنگ مینجمنٹ کی کے مالک کے بیلنس سے کاٹی جاتی ہے۔

یہ ایک وائٹ لیبل ماڈل ہے: آپ کے کلائنٹ اپنی gc- keys کے ذریعے کام کرتے ہیں اور 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- key ملتی ہے جس کی حد 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 کے ذریعے مکمل CRUD:

ڈیش بورڈ کے ذریعے بھی انتظام دستیاب ہے: API Keys → Management Keys سیکشن۔

JoinGonka انتظام کیز (management keys) کے لیے GNK-لمٹس، TTL اور Dashboard UI فراہم کرتا ہے — جو کہ سستے Gonka-انفرنس-نیٹ ورک کے اوپر کام کرتا ہے۔