الانتقال إلى المحتوى الرئيسي
GET
/
api
/
token
cURL
curl "https://api.cometapi.com/api/token/?p=1&page_size=20" \
  -H "Authorization: your-access-token"
{
  "success": true,
  "message": "",
  "data": {
    "page": 1,
    "page_size": 20,
    "total": 1,
    "items": [
      {
        "id": 1234,
        "user_id": 5678,
        "key": "$COMETAPI_KEY",
        "status": 1,
        "name": "production",
        "created_time": 1766102400,
        "accessed_time": 1766102400,
        "expired_time": -1,
        "remain_quota": 100000,
        "unlimited_quota": false,
        "model_limits_enabled": false,
        "model_limits": "",
        "allow_ips": null,
        "used_quota": 0,
        "group": "",
        "cross_group_retry": false
      }
    ]
  }
}
استخدم نقطة النهاية هذه لسرد مفاتيح API التي تنتمي إلى حساب CometAPI الموثق. يتم إرجاع أحدث المفاتيح أولاً.
أنشئ personal access token من Console → Personal Settings، ثم أرسله كقيمة خام لترويسة Authorization. لا تضف إليه البادئة Bearer.

الترقيم

Query parameterالوصف
pرقم الصفحة. القيمة الافتراضية هي 1.
page_sizeعدد العناصر في كل صفحة. القيم التي تتجاوز 100 يتم تقييدها إلى 100.

حالة مفتاح API

Statusالمعنى
1مفعّل
2معطّل
3منتهي الصلاحية
4مستنفد

الحقول المُعادة

FieldTypeالوصف
idintegerمعرّف مفتاح API رقمي. استخدم هذه القيمة مع الحصول على مفتاح API واحد، وتحديث مفتاح API، وحذف مفتاح API.
keystringقيمة مفتاح API التي تُرجعها واجهة API الإدارية. تعامل معها كسر واستخدمها بالشكل Authorization: Bearer $COMETAPI_KEY لطلبات النموذج.
statusintegerالحالة التشغيلية. فقط 1 تعني أن المفتاح مفعّل لطلبات النموذج.
namestringاسم عرض مقروء للمستخدم لهذا المفتاح.
created_timeintegerطابع زمني Unix بالثواني عند إنشاء المفتاح.
accessed_timeintegerطابع زمني Unix بالثواني لآخر مرة استُخدم فيها المفتاح.
expired_timeintegerطابع زمني Unix بالثواني عند انتهاء صلاحية المفتاح. -1 تعني عدم وجود انتهاء صلاحية.
remain_quotaintegerالحصة المتبقية بوحدات الحصة الداخلية في CometAPI.
used_quotaintegerالحصة التي استهلكها هذا المفتاح بالفعل بوحدات الحصة الداخلية في CometAPI.
unlimited_quotabooleanما إذا كان المفتاح يتجاوز فحوصات الحصة المتبقية.
model_limits_enabledbooleanما إذا كانت قيود النموذج مفعّلة لهذا المفتاح.
model_limitsstringmodel IDs المسموح بها لهذا المفتاح، مفصولة بفواصل، عندما تكون model_limits_enabled هي true. القيمة الفارغة تعني عدم وجود قائمة نماذج مُهيأة.
allow_ipsstring or nullقائمة IP المسموح بها على شكل سلسلة واحدة مفصولة بأسطر جديدة. يمكن أن يكون كل إدخال عنوان IPv4 منفردًا، أو عنوان IPv6 منفردًا، أو IPv4 CIDR، أو IPv6 CIDR. null أو "" يعني عدم وجود تقييد على IP.
groupstringقيد مجموعة الحساب. القيمة الفارغة تعني عدم وجود قيد صريح على المجموعة.
cross_group_retrybooleanما إذا كانت إعادة المحاولة عبر المجموعات مفعّلة للتوجيه التلقائي بين المجموعات.

التفويضات

Authorization
string
header
مطلوب

Personal access token copied from CometAPI Console > Personal Settings. Send the raw token value; do not prefix it with Bearer.

معلمات الاستعلام

p
integer
افتراضي:1

Page number to return. Defaults to 1.

النطاق المطلوب: x >= 1
page_size
integer
افتراضي:20

Number of keys per page. Values above 100 are capped at 100 by the backend.

النطاق المطلوب: 1 <= x <= 100

الاستجابة

200 - application/json

Paginated API key list.

success
boolean
مطلوب
message
string
مطلوب
data
object
مطلوب