مفاتيح API
سرد مفاتيح API
اعرض مفاتيح API الخاصة بـ CometAPI للحساب الموثق مع دعم الترقيم.
GET
cURL
استخدم نقطة النهاية هذه لسرد مفاتيح API التي تنتمي إلى حساب CometAPI الموثق. يتم إرجاع أحدث المفاتيح أولاً.
أنشئ personal access token من Console → Personal Settings، ثم أرسله كقيمة خام لترويسة
Authorization. لا تضف إليه البادئة Bearer.الترقيم
| Query parameter | الوصف |
|---|---|
p | رقم الصفحة. القيمة الافتراضية هي 1. |
page_size | عدد العناصر في كل صفحة. القيم التي تتجاوز 100 يتم تقييدها إلى 100. |
حالة مفتاح API
| Status | المعنى |
|---|---|
1 | مفعّل |
2 | معطّل |
3 | منتهي الصلاحية |
4 | مستنفد |
الحقول المُعادة
| Field | Type | الوصف |
|---|---|---|
id | integer | معرّف مفتاح API رقمي. استخدم هذه القيمة مع الحصول على مفتاح API واحد، وتحديث مفتاح API، وحذف مفتاح API. |
key | string | قيمة مفتاح API التي تُرجعها واجهة API الإدارية. تعامل معها كسر واستخدمها بالشكل Authorization: Bearer $COMETAPI_KEY لطلبات النموذج. |
status | integer | الحالة التشغيلية. فقط 1 تعني أن المفتاح مفعّل لطلبات النموذج. |
name | string | اسم عرض مقروء للمستخدم لهذا المفتاح. |
created_time | integer | طابع زمني Unix بالثواني عند إنشاء المفتاح. |
accessed_time | integer | طابع زمني Unix بالثواني لآخر مرة استُخدم فيها المفتاح. |
expired_time | integer | طابع زمني Unix بالثواني عند انتهاء صلاحية المفتاح. -1 تعني عدم وجود انتهاء صلاحية. |
remain_quota | integer | الحصة المتبقية بوحدات الحصة الداخلية في CometAPI. |
used_quota | integer | الحصة التي استهلكها هذا المفتاح بالفعل بوحدات الحصة الداخلية في CometAPI. |
unlimited_quota | boolean | ما إذا كان المفتاح يتجاوز فحوصات الحصة المتبقية. |
model_limits_enabled | boolean | ما إذا كانت قيود النموذج مفعّلة لهذا المفتاح. |
model_limits | string | model IDs المسموح بها لهذا المفتاح، مفصولة بفواصل، عندما تكون model_limits_enabled هي true. القيمة الفارغة تعني عدم وجود قائمة نماذج مُهيأة. |
allow_ips | string or null | قائمة IP المسموح بها على شكل سلسلة واحدة مفصولة بأسطر جديدة. يمكن أن يكون كل إدخال عنوان IPv4 منفردًا، أو عنوان IPv6 منفردًا، أو IPv4 CIDR، أو IPv6 CIDR. null أو "" يعني عدم وجود تقييد على IP. |
group | string | قيد مجموعة الحساب. القيمة الفارغة تعني عدم وجود قيد صريح على المجموعة. |
cross_group_retry | boolean | ما إذا كانت إعادة المحاولة عبر المجموعات مفعّلة للتوجيه التلقائي بين المجموعات. |
التفويضات
Personal access token copied from CometAPI Console > Personal Settings. Send the raw token value; do not prefix it with Bearer.
معلمات الاستعلام
Page number to return. Defaults to 1.
النطاق المطلوب:
x >= 1Number of keys per page. Values above 100 are capped at 100 by the backend.
النطاق المطلوب:
1 <= x <= 100