الحساب

أدر مفاتيح API لحسابك في AgentSend. أنشئ مفاتيح لوكلاء أو تكاملات جديدة، اعرض المفاتيح الموجودة، وألغِ أي مفتاح فوراً.

⚠

تُرجع قيمة مفتاح API الكاملة مرة واحدة فقط عند الإنشاء. خزّنها بأمان (مثلاً في مدير أسرار أو متغير بيئة) — لا يمكن استرجاعها.

إنشاء مفتاح API

POST /account/api-keys

ينشئ مفتاح API جديد للحساب المُصادَق. تتضمن الاستجابة السلسلة الكاملة للمفتاح؛ هذه هي المرة الوحيدة التي يظهر فيها.

جسم الطلب

Content-Type: application/json

الحقل	النوع	الوصف
`name`	string	تسمية مقروءة للمفتاح (مثل `"production-agent"`). اختياري.

مثال على الطلب

bash

curl -X POST https://api.agentsend.io/account/api-keys \
  -H "x-api-key: $AGENTSEND_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "production-agent"}'

الاستجابة — 201 Created

json

{
  "id": "ak_01j9zxkp4qbc7n3m8td5e6fvg2",
  "key": "as_live_v1_4xKqT2mNpRuWsYcBjDeGhLzA...",
  "prefix": "as_live_v1_4xKq",
  "name": "production-agent",
  "message": "Store this key securely. It will not be shown again."
}

كائن CreatedApiKey

Field	Type	Description
`id`	string	المعرّف الفريد لمفتاح API.
`key`	string	قيمة مفتاح API الكاملة. تُعرض مرة واحدة فقط.
`prefix`	string	البادئة المرئية المستخدَمة لتحديد هذا المفتاح في القوائم.
`name`	string \| null	تسمية مقروءة قُدّمت عند الإنشاء.
`message`	string	رسالة تنبيهية تذكّرك بتخزين المفتاح بأمان.

قائمة مفاتيح API

GET /account/api-keys

تُرجع جميع مفاتيح API النشطة في الحساب. لا تُرجع قيم المفاتيح أبداً في هذه النقطة — تُعرض البيانات الوصفية فقط.

مثال على الطلب

bash

curl https://api.agentsend.io/account/api-keys \
  -H "x-api-key: $AGENTSEND_API_KEY"

الاستجابة — 200 OK

json

{
  "data": [
    {
      "id": "ak_01j9zxkp4qbc7n3m8td5e6fvg2",
      "keyPrefix": "as_live_v1_4xKq",
      "name": "production-agent",
      "lastUsedAt": "2025-11-02T14:23:00Z",
      "expiresAt": null,
      "createdAt": "2025-10-15T09:00:00Z"
    },
    {
      "id": "ak_02k0aylq5rcd8o4n9ue6f7gwh3",
      "keyPrefix": "as_live_v1_9mHr",
      "name": null,
      "lastUsedAt": null,
      "expiresAt": "2026-01-01T00:00:00Z",
      "createdAt": "2025-12-01T10:30:00Z"
    }
  ]
}

كائن ApiKey

Field	Type	Description
`id`	string	Unique identifier for the API key.
`keyPrefix`	string	البادئة المرئية للمفتاح، تُستخدم لتحديده دون كشف السر.
`name`	string \| null	تسمية مقروءة، إن ضُبطت عند الإنشاء.
`lastUsedAt`	string \| null	طابع ISO 8601 لآخر طلب مُصادَق بهذا المفتاح.
`expiresAt`	string \| null	طابع انتهاء الصلاحية ISO 8601، أو `null` إذا كان المفتاح لا ينتهي.
`createdAt`	string	طابع زمني ISO 8601 لوقت إنشاء المفتاح.

إلغاء مفتاح API

DELETE /account/api-keys/{id}

يلغي مفتاح API نهائياً. أي طلبات مُصادقة بهذا المفتاح ستُرفض فوراً. لا يمكن التراجع عن هذا الإجراء.

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

المعامل	Type	Description
`id` مطلوب	uuid	معرّف مفتاح API المطلوب إلغاؤه.

مثال على الطلب

bash

curl -X DELETE https://api.agentsend.io/account/api-keys/ak_01j9zxkp4qbc7n3m8td5e6fvg2 \
  -H "x-api-key: $AGENTSEND_API_KEY"

الاستجابة — 204 No Content

استجابة فارغة بحالة 204 تؤكد أن المفتاح أُلغي. لا يُرجع جسم استجابة.

ℹ

لا يمكنك إلغاء المفتاح المستخدَم حالياً لمصادقة الطلب. استخدم مفتاحاً مختلفاً (أو لوحة التحكم) لإلغاء مفتاح قيد الاستخدام.

← السابق API: النطاقات التالي → API: المرفقات