الانتقال إلى المحتوى الرئيسي
GET
/
api
/
token
/
{id}
cURL
curl https://api.cometapi.com/api/token/1234 \
  -H "Authorization: your-access-token"
{
  "success": true,
  "message": "",
  "data": {
    "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
  }
}
استخدم هذا endpoint لاسترجاع سجل مفتاح API واحد بواسطة المعرف.
أنشئ personal access token من Console → Personal Settings، ثم أرسله كقيمة خام لترويسة Authorization. لا تسبقه بـ Bearer.
إن معلمة المسار id هي معرّف المفتاح الرقمي الذي يتم إرجاعه بواسطة List API keys.

​
حالة مفتاح API

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

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

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

التفويضات

​
Authorization
string
header
مطلوب

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

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

​
id
integer
مطلوب

Numeric API key ID returned by the list endpoint.

الاستجابة

200 - application/json

API key record.

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