استعلم برمجيًا عن استخدام مفاتيح API الخاصة بك وتاريخ انتهاء صلاحيتها
أنشئ token وصول للقراءة فقط في لوحة التحكم، واستعلم عن تاريخ انتهاء صلاحية كل مفتاح API نشط، والاستخدام اليومي، والحصة بأمر واحد — ثم اربطه بنصوصك البرمجية ولوحات التحكم والتنبيهات الخاصة بك.
ما يمكنك الاستعلام عنه
يغطي token واحد المؤشرات التشغيلية الرئيسية لمفاتيح API الخاصة بك
تاريخ انتهاء الصلاحية
تاريخ الانتهاء الدقيق لكل مفتاح API نشط، لتتمكن من التخطيط للتجديد مسبقًا وتجنب التوقف.
الاستخدام اليومي والشهري
تكلفة اليوم وعدد الطلبات، إضافة إلى الحصة المستخدمة / الحد لهذا الشهر ونسبة الاستخدام بنظرة سريعة.
token للخدمة الذاتية
أنشئ token أو أعد تعيينه أو ألغِه في لوحة التحكم؛ لا يخزّن الخادم سوى قيمة التجزئة ويعرض النص الصريح مرة واحدة.
ثلاث خطوات للتكامل
من إنشاء token إلى استعلام يعمل في دقائق
أنشئ token في لوحة التحكم
سجّل الدخول، وافتح بطاقة Open API، وانقر على إنشاء، واحصل على token وصول qot_ (احتفظ به بأمان).
استدعِ API باستخدام token
أضف Authorization: Bearer qot_... وستعيد GET /api/v1/openapi/keys استخدامك بصيغة JSON.
ادمجه في أدواتك
مرّر الاستجابة إلى النصوص البرمجية أو لوحات تحكم المراقبة أو تنبيهات انتهاء الصلاحية أو خطوط CI لأتمتة العمليات.
ابدأ بأمر واحد
HTTP عادي + token Bearer — استدعِه من أي لغة
تعيد نقطة النهاية JSON منظمًا يتضمن اسم كل مفتاح نشط، وتاريخ انتهاء صلاحيته، واستخدام اليوم، والحصة الشهرية — جاهزًا للتحليل.
- •للقراءة فقط: يمكنه فقط الاستعلام عن مفاتيح API الخاصة بحسابك — ولا ينشئ أو يعدّل المفاتيح أو يستهلك الرصيد إطلاقًا.
- •يحافظ التخزين المؤقت المدمج وتحديد معدل الطلبات على سرعته وخفة استهلاكه للموارد.
# الطلب
curl -H "Authorization: Bearer qot_xxx" \
https://qcode.cc/api/v1/openapi/keysمثال استجابة
{
"ok": true,
"data": {
"keys": [{
"name": "Pro unlimited/day",
"is_active": true,
"expires_at_display": "2026/08/22 21:35",
"current_daily_cost": 42.04,
"current_requests": 115,
"monthly_cost_used": 1683.29,
"monthly_cost_limit": 4000.0
}],
"active_api_keys": 1
}
}بالنسبة لمفاتيح Ultimate، يغطي monthly_cost_used / monthly_cost_limit دورة الـ30 يومًا الحالية (المستخدم في هذه الدورة / الحصة الشهرية) ويبدأ من جديد كل دورة؛ ولا تزال مفاتيح Ultimate الأقدم التي لا تتضمن إعادة التعيين الشهرية تعرض الاستخدام الكلي / الميزانية الإجمالية.
نقاط النهاية
جميعها GET للقراءة فقط، وتتم المصادقة عليها باستخدام token Bearer
| نقطة النهاية | الوصف |
|---|---|
| GET /api/v1/openapi/keys | يسرد جميع مفاتيح API النشطة لديك مع تاريخ انتهاء الصلاحية، واستخدام اليوم، والحصة الشهرية، ونسبة الاستخدام. |
| GET /api/v1/openapi/me | ملخص على مستوى الحساب: عدد المفاتيح النشطة والتكلفة الإجمالية لليوم. |
| GET /api/v1/openapi | وصف ذاتي: يعيد قائمة نقاط النهاية والاستخدام، مفيد لفحوصات النشاط. |
حالات الاستخدام الشائعة
أدمج بيانات الاستخدام في سير عملك الحالي
تنبيهات انتهاء الصلاحية
تحقق من تاريخ الانتهاء وفق جدول وأرسل تذكيرات تلقائيًا عبر البريد الإلكتروني / IM / Telegram قبل انتهاء صلاحية المفاتيح.
لوحة تحكم الاستخدام
مرّر التكلفة اليومية ونسبة استخدام الحصة إلى Grafana أو جداول البيانات أو لوحتك الخاصة.
مراقبة مفاتيح متعددة
عندما يمتلك فريق عدة مفاتيح، اجلب حالة الصحة والحصة لجميعها دفعة واحدة.
CI / الأتمتة
تحقق من أن مفتاحًا ما لا يزال صالحًا ولديه حصة في خط الأنابيب الخاص بك قبل تشغيل مهام ذكاء اصطناعي مكلفة.
الأمان حسب التصميم
إن token عبارة عن سلسلة عشوائية عالية الإنتروبيا؛ لا يخزّن الخادم سوى قيمة تجزئة HMAC ويكشف النص الصريح مرة واحدة. إنه للقراءة فقط بشكل صارم — لا يمكنه إنشاء المفاتيح أو إدارتها أو المساس برصيدك — مع حدود مدمجة لمعدل الطلبات في الدقيقة / اليوم. إذا تسرّب، فأعد تعيينه بنقرة واحدة وسيُبطل token القديم فورًا.
الأسئلة الشائعة
كيف أحصل على token وصول؟
سجّل الدخول إلى QCode، وافتح بطاقة Open API في لوحة التحكم، وانقر على إنشاء. يُعرض نص token الصريح مرة واحدة فقط، لذا انسخه فورًا؛ ويمكنك إعادة تعيينه في أي وقت إذا فُقد.
هل token آمن؟
نعم. إنه للقراءة فقط ويمكنه الاستعلام فقط عن استخدام مفاتيح API وتاريخ انتهاء صلاحيتها في حسابك — ولا يمكنه إنشاء المفاتيح أو تعديلها أو استهلاك الرصيد. لا يخزّن الخادم سوى قيمة تجزئة، وتؤدي إعادة التعيين بنقرة واحدة إلى إبطال token مسرّب.
هل توجد حدود لمعدل الطلبات؟
نعم. لكل token حدود لعدد الاستدعاءات في الدقيقة واليوم، وتُخزَّن النتائج مؤقتًا لبضع ثوانٍ — وهو كافٍ للاستطلاع والمراقبة المنتظمين. تواصل مع الدعم إذا كنت بحاجة إلى حصة أعلى.
ابدأ الاستعلام عن استخدامك الآن
سجّل الدخول، وأنشئ token وصولك للقراءة فقط، واربط تنبيهات انتهاء الصلاحية ولوحات تحكم الاستخدام في دقائق.