API Overview

أهلاً بك في وثائق Minds API. يتيح لك API الخاص بنا إنشاء وإدارة AI minds برمجياً، ورفع المعرفة، والتفاعل معها.

البدء

Minds API منظَّم حول مبادئ REST. لـ API الخاص بنا URLs موجهة نحو الموارد يمكن توقعها، ويقبل أجسام طلب بترميز JSON، ويُرجع استجابات بترميز JSON، ويستخدم رموز استجابة HTTP ومصادقة وأفعال قياسية.

Base URL

Production: https://getminds.ai/api/v1 أو https://api.getminds.ai/v1

Local Development: http://localhost:3000/api/v1

كلا base URLs للإنتاج متكافئان تماماً. يُوصى بالنطاق الفرعي api.getminds.ai للحصول على URLs تكامل أنظف.

المصادقة

تتطلب جميع endpoints الـ API مصادقة عبر مفتاح API. يمكنك توليد وإدارة مفاتيح API الخاصة بك في Settings → API Keys.

ضمّن مفتاح API الخاص بك في ترويسة Authorization:

Authorization: Bearer minds_your_api_key_here

مواصفة OpenAPI

تُنشَر مواصفة OpenAPI 3.1.0 قابلة للقراءة آليًا على /_openapi.json. استخدم المواصفة لتوليد عملاء بأنواع محددة (TypeScript وPython وغيرها) أو لإسقاطها في نموذج LLM للحصول على كود تكامل بضربة واحدة. راجع OpenAPI للاطّلاع على أمثلة.

Content Type

يجب أن تتضمن جميع الطلبات التي ترسل بيانات ترويسة Content-Type:

Content-Type: application/json

لرفع الملفات، استخدم:

Content-Type: multipart/form-data

Endpoints المتاحة

Sparks

أنشئ وأدِر AI minds (agents) بتهيئات مخصصة.

• GET /api/v1/sparks — عرض جميع الـ sparks
• GET /api/v1/sparks/{sparkId} — الحصول على تفاصيل spark
• POST /api/v1/sparks — إنشاء spark جديد
• PUT /api/v1/sparks/{sparkId} — تحديث spark
• DELETE /api/v1/sparks/{sparkId} — حذف spark
• POST /api/v1/sparks/{sparkId}/regenerate-prompt — إعادة توليد نظام البرومبت من المعرفة

Knowledge

أدِر المعرفة للـ minds الخاصة بك.

• GET /api/v1/sparks/{sparkId}/knowledge — عرض عناصر المعرفة
• POST /api/v1/sparks/{sparkId}/knowledge — إضافة معرفة (روابط أو ملفات أو بحث بالكلمات المفتاحية)
• PUT /api/v1/sparks/{sparkId}/knowledge/{itemId} — تحديث عنصر معرفة
• DELETE /api/v1/sparks/{sparkId}/knowledge/{itemId} — حذف عنصر معرفة
• POST /api/v1/sparks/{sparkId}/knowledge/enrich — إثراء عبر البحث بالكلمات المفتاحية (اختصار مريح)
• GET /api/v1/sparks/{sparkId}/knowledge/patterns — الحصول على أنماط المعرفة حسب الإطار

Chat

تفاعل مع الـ minds الخاصة بك عبر إكمالات المحادثة.

• POST /api/v1/sparks/{sparkId}/completion — إرسال الرسائل والحصول على الاستجابات

Panels

أنشئ وأدِر AI panels لاستطلاع مجموعات من الـ minds.

• GET /api/v1/panels — عرض جميع الـ panels
• POST /api/v1/panels — إنشاء panel جديد
• GET /api/v1/panels/{panelId} — الحصول على تفاصيل panel مع سجل الرسائل
• POST /api/v1/panels/{panelId}/ask — طرح سؤال على جميع minds الـ panel (SSE stream)
• POST /api/v1/panels/{panelId}/export — تصدير نتائج panel كتقرير
• GET /api/v1/panels/{panelId}/export-status — فحص حالة مهمة التصدير
• GET /api/v1/panels/{panelId}/export-download — تنزيل PDF المُصدَّر

User

endpoints متعلقة بالمستخدم.

• GET /api/v1/auth/me — الحصول على المستخدم المصادق الحالي
• GET /api/v1/user/shareable-sparks — عرض الـ minds المتاحة للمشاركة

API Keys

أدِر مفاتيح API الخاصة بك للمصادقة.

• GET /api/v1/api-keys — عرض مفاتيح API الخاصة بك
• POST /api/v1/api-keys — إنشاء مفتاح API جديد
• DELETE /api/v1/api-keys/{keyId} — حذف مفتاح API

مثال سريع

إليك مثال سريع لإنشاء mind والمحادثة معه:

# 1. Create a mind (keywords mode)
curl -X POST "https://getminds.ai/api/v1/sparks" \
  -H "Authorization: Bearer minds_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Marketing Expert",
    "description": "Expert in digital marketing strategies",
    "mode": "keywords",
    "type": "expert",
    "discipline": "Marketing",
    "keywords": ["SEO", "content marketing", "social media", "analytics"]
  }'

# Response: { "data": { "id": "spark-id", ... }, "processing": { "queued": true, ... } }

# 2. Create a mind from social profile (clone mode)
curl -X POST "https://getminds.ai/api/v1/sparks" \
  -H "Authorization: Bearer minds_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Influencer Clone",
    "description": "AI trained on influencer social presence",
    "mode": "clone",
    "type": "creative",
    "discipline": "Social Media Marketing",
    "personaContext": "https://twitter.com/username"
  }'

# 3. Chat with the mind
curl -X POST "https://getminds.ai/api/v1/sparks/spark-id/completion" \
  -H "Authorization: Bearer minds_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "messages": [
      {
        "role": "user",
        "content": "What are the top social media trends for 2025?"
      }
    ]
  }'

الخطوات التالية

• تعرّف على المصادقة
• استكشف Sparks endpoints
• اقرأ عن إدارة المعرفة
• افهم Chat completions
• أنشئ Panels لاستطلاعات متعددة الـ minds
• راجع Latency والأداء
• اتصل عبر MCP Integration
• راجع Errors والحدود

حدود الباقات

يخضع استخدام API لباقة اشتراكك:

عرض الباقات

هل تحتاج إلى مساعدة؟

إذا كان لديك أسئلة أو تحتاج إلى دعم في API:

• راجع الدليل
• تواصل معنا عبر نموذج الملاحظات
• انضم إلى نقاشات مجتمعنا