ম্যানেজমেন্ট কীজ — Gonka-এ SaaS

ম্যানেজমেন্ট কীগুলি হল গঙ্কা এআই গেটওয়ের উপরে SaaS পণ্য তৈরির জন্য অনুক্রমিক API কীয়ের একটি সিস্টেম।

আর্কিটেকচারটি দ্বি-স্তরের:

• ম্যানেজমেন্ট কী (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 দৈনিক 1 GNK এবং প্রতি মিনিটে 30টি অনুরোধের সীমা সহ একটি gc- কী পায়।

প্রতিটি চাইল্ড কী তিনটি ধরণের সীমাবদ্ধতা সমর্থন করে:

• দৈনিক সীমা (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 কীজ → ম্যানেজমেন্ট কীজ বিভাগ।

JoinGonka — management keys-এর জন্য GNK-সীমা, TTL এবং ড্যাশবোর্ড UI সহ একমাত্র Gonka-গেটওয়ে।