المصادقة

تتم مصادقة Nexevo API بمفتاح API مرتبط بمساحة عمل، يُرسل كـ Bearer token.

الترويسة

أرسل مفتاحك في ترويسة Authorization مع كل طلب:

http

Authorization: Bearer sk-ws-...

المفتاح المفقود أو غير الصالح أو التابع لمساحة عمل خاطئة يُرجع 401.

المفاتيح محدودة بمساحة العمل

ينتمي كل مفتاح إلى مساحة عمل واحدة تحديدًا. تقع مُنفّذات الموارد تحت /v1/workspaces/{workspace_id}/…، ويجب أن تطابق مساحة عمل المفتاح الـ {workspace_id} في المسار — لا يمكن لمفتاح الوصول إلى بيانات مساحة عمل أخرى. للعمل مع عدة مساحات عمل، أنشئ مفتاحًا واحدًا لكل مساحة.

إدارة المفاتيح

أنشئ المفاتيح واسردها وأبطِلها من التطبيق (Settings ← API keys) أو عبر الـ API:

POST/v1/workspaces/{workspace_id}/api-keys —

إنشاء مفتاح. يُرجع السر مرة واحدة فقط في الاستجابة؛ خزّنه بأمان.

GET/v1/workspaces/{workspace_id}/api-keys —

سرد المفاتيح (البيانات الوصفية فقط — ليس السر أبدًا).

DELETE/v1/workspaces/{workspace_id}/api-keys/{key_id} —

إبطال مفتاح فورًا.

bash

# Create a key
curl https://nexevo.ai/v1/workspaces/$NEXEVO_WORKSPACE/api-keys \
  -H "Authorization: Bearer $EXISTING_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "production-backend"}'

يمنح المفتاح وصولاً كاملًا إلى مساحة عمله — قراءة وكتابة Memory، وتشغيل الـ agents (التي تستهلك رصيد مساحة العمل)، والمزيد. احتفظ بالمفاتيح على خادمك، واضبط واحدًا لكل بيئة، وأبطِل أي مفتاح قد يكون تسرّب.

الجلسات مقابل مفاتيح الـ API

تُصادق تطبيق الويب المستخدمين بجلسات تسجيل دخول (cookies)؛ هذه مخصصة للواجهة. للوصول البرمجي — الخادم الخلفي، السكربتات، التكاملات — استخدم دائمًا مفتاح API، لا جلسة.