> ## Documentation Index > Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt > Use this file to discover all available pages before exploring further. # استرجاع مفتاح API > استخدم CometAPI GET /api/token/{id} لاسترجاع سجل مفتاح API واحد حسب المعرّف للحساب المصادق عليه. استخدم نقطة النهاية هذه لاسترجاع سجل مفتاح API واحد حسب المعرّف. أنشئ personal access token من [Console → Personal Settings](https://www.cometapi.com/console/personal)، ثم أرسله كقيمة خام لترويسة `Authorization`. لا تضف إليه البادئة `Bearer`. المعلمة `id` في المسار هي معرّف المفتاح الرقمي الذي يتم إرجاعه من [List API keys](./list-api-keys). ## حالة مفتاح API | Status | Meaning | | ------ | -------------- | | `1` | مفعّل | | `2` | معطّل | | `3` | منتهي الصلاحية | | `4` | مستنفد | ## الحقول المُعادة | Field | Type | Description | | ---------------------- | -------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `id` | integer | معرّف مفتاح API رقمي. استخدم هذه القيمة مع [Update an API key](./update-api-key) و[Delete an API key](./delete-api-key). | | `key` | string | قيمة مفتاح API التي تُعيدها management 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 | ما إذا كانت إعادة المحاولة عبر المجموعات مفعّلة للتوجيه التلقائي بين المجموعات. | ## OpenAPI ````yaml api/openapi/api-keys/get-api-key.openapi.json GET /api/token/{id} openapi: 3.1.0 info: title: Get API Key version: 1.0.0 servers: - url: https://api.cometapi.com security: - accessTokenAuth: [] paths: /api/token/{id}: get: summary: Get a single API key description: Retrieve one API key record by ID for the authenticated account. operationId: getApiKey parameters: - name: id in: path required: true description: Numeric API key ID returned by the list endpoint. schema: type: integer responses: '200': description: API key record. content: application/json: schema: type: object required: - success - message - data properties: success: type: boolean message: type: string data: $ref: '#/components/schemas/ApiKey' examples: success: summary: API key record value: 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 x-codeSamples: - lang: curl label: cURL source: |- curl https://api.cometapi.com/api/token/1234 \ -H "Authorization: your-access-token" components: schemas: ApiKey: type: object properties: id: type: integer description: >- Numeric API key ID. Use this value with the get, update, and delete endpoints. example: 1234 user_id: type: integer description: Account user ID that owns the key. example: 5678 key: type: string description: >- API key value returned by the management API. Treat it as a secret and use it as `Authorization: Bearer $COMETAPI_KEY` for model requests. example: $COMETAPI_KEY status: type: integer description: >- Operational status for the key. `1` means enabled, `2` disabled, `3` expired, and `4` exhausted. Only enabled keys are accepted by model endpoints. enum: - 1 - 2 - 3 - 4 example: 1 name: type: string description: User-readable display name for the API key. example: production maxLength: 50 created_time: type: integer description: Unix timestamp in seconds when the key was created. example: 1766102400 accessed_time: type: integer description: >- Unix timestamp in seconds when the key was last used. Newly created keys may show the creation time until first use. example: 1766102400 expired_time: type: integer description: >- Unix timestamp in seconds when the key expires. `-1` means no expiration. example: -1 remain_quota: type: integer description: >- Remaining quota for this key in CometAPI internal quota units. When this reaches `0` and `unlimited_quota` is `false`, model requests are rejected as quota exhausted. example: 100000 unlimited_quota: type: boolean description: Whether the key bypasses remaining-quota checks. example: false model_limits_enabled: type: boolean description: >- Whether model restrictions are active for this key. When `false`, `model_limits` is ignored. example: false model_limits: type: string description: >- Comma-separated model IDs allowed by this key when `model_limits_enabled` is `true`. Empty means no configured model list. example: '' allow_ips: type: - string - 'null' description: >- Optional IP allowlist stored as one newline-separated string. Each entry can be a single IPv4 address, single IPv6 address, IPv4 CIDR, or IPv6 CIDR. Example: `198.51.100.10\n203.0.113.0/24\n2001:db8::/32`. `null` or `""` means IP restrictions are disabled. example: |- 198.51.100.10 203.0.113.0/24 2001:db8::/32 used_quota: type: integer description: Quota already consumed by this key in CometAPI internal quota units. example: 0 group: type: string description: >- Account group restriction for this key. Empty means no explicit group restriction. example: '' cross_group_retry: type: boolean description: >- Whether cross-group retry is enabled for automatic group routing. This is only meaningful when the key uses an auto-routed group such as `auto`. example: false additionalProperties: true securitySchemes: accessTokenAuth: type: apiKey in: header name: Authorization description: >- Personal access token copied from CometAPI Console > Personal Settings. Send the raw token value; do not prefix it with `Bearer`. ````