مفاتيح API
عرض مفاتيح API
استخدم CometAPI GET /api/token/ لعرض مفاتيح API الخاصة بالحساب المصادَق عليه مع دعم الترقيم الصفحي.
GET
/
api
/
token
/
cURL
curl "https://api.cometapi.com/api/token/?p=1&page_size=20" \
-H "Authorization: your-access-token"import requests
url = "https://api.cometapi.com/api/token/"
headers = {"Authorization": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: '<api-key>'}};
fetch('https://api.cometapi.com/api/token/', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.cometapi.com/api/token/",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.cometapi.com/api/token/"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.cometapi.com/api/token/")
.header("Authorization", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.cometapi.com/api/token/")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"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 | Description |
|---|---|
p | رقم الصفحة. القيمة الافتراضية هي 1. |
page_size | عدد العناصر في كل صفحة. يتم تقييد القيم الأكبر من 100 إلى 100. |
حالة مفتاح API
| Status | Meaning |
|---|---|
1 | مفعّل |
2 | معطّل |
3 | منتهي الصلاحية |
4 | مستنفد |
الحقول المُعادة
| Field | Type | Description |
|---|---|---|
id | integer | معرّف مفتاح API رقمي. استخدم هذه القيمة مع الحصول على مفتاح API واحد، وتحديث مفتاح API، وحذف مفتاح API. |
key | string | قيمة مفتاح API التي تُرجعها واجهة إدارة API. تعامل معها كسر واستخدمها بالشكل Authorization: Bearer $COMETAPI_KEY لطلبات model. |
status | integer | الحالة التشغيلية. فقط القيمة 1 تعني أن المفتاح مفعّل لطلبات model. |
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 مفعّلة لهذا المفتاح. |
model_limits | string | model ID مفصولة بفواصل والمسموح بها لهذا المفتاح عندما تكون model_limits_enabled هي true. وتعني القيمة الفارغة عدم وجود قائمة model مُعدّة. |
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⌘I
cURL
curl "https://api.cometapi.com/api/token/?p=1&page_size=20" \
-H "Authorization: your-access-token"import requests
url = "https://api.cometapi.com/api/token/"
headers = {"Authorization": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: '<api-key>'}};
fetch('https://api.cometapi.com/api/token/', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.cometapi.com/api/token/",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.cometapi.com/api/token/"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.cometapi.com/api/token/")
.header("Authorization", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.cometapi.com/api/token/")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"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
}
]
}
}