إنشاء مفتاح API

الطلب

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

تتطلب هذه النقطة مصادقة بالجلسة (يجب أن تكون مسجّلاً عبر اللوحة).

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

namestringRequired

اسم وصفي للمفتاح (مثل "Production App" أو "CI Pipeline" أو "MCP Integration"). يساعد على تمييز المفتاح في لوحتك.

permissionsstring[]Optional

Default: ['posts:create', 'posts:read']

مصفوفة الصلاحيات الممنوحة لهذا المفتاح. الصلاحيات المتاحة:

posts:read — قراءة المنشورات والاتصالات
posts:create — إنشاء وجدولة ونشر المنشورات

مثال طلب

curl -X POST https://app.ewasl.com/api/settings/api-keys \
  -H "Authorization: Bearer ewasl_YOUR_SESSION_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "MCP Integration",
    "permissions": ["posts:create", "posts:read"]
  }'

الاستجابة

apiKeystring

المفتاح الكامل غير المُقنّع. احفظه فوراً — لن يُعرض مرة أخرى. الصيغة: ewasl_ متبوعةً بسلسلة عشوائية.

keyobject

بيانات وصفية عن المفتاح المُنشأ.

Response Example

{
  "apiKey": "ewasl_sk_live_a1b2c3d4e5f6g7h8i9j0...",
  "key": {
    "id": "key_123abc",
    "name": "MCP Integration",
    "permissions": ["posts:create", "posts:read"],
    "created_at": "2026-03-01T12:00:00Z"
  }
}