Felo APIs

Mindmap API

أنشئ خرائط ذهنية من الـ prompts وسياق LiveDoc الاختياري.

POST/v2/mindmap

المصادقة

Bearer API key

نوع المحتوى

application/json

ملاحظات السعر

قد تنطبق حدود خاصة بـ endpoint.

LiveDoc API

يوفر Mindmap API قدرات توليد الخرائط الذهنية. يمكنك إنشاء خريطة ذهنية بموضوع أو سؤال، ويمكنك اختياريًا تحديد نوع التخطيط.

المصادقة

تتطلب كل الطلبات مفتاح API في رأس Authorization:

Authorization: Bearer YOUR_API_KEY

الاستخدام مع وكلاء الذكاء الاصطناعي

ثبّت حزمة felo-ai الكاملة لتمكين وكيل من إنشاء الخرائط الذهنية إلى جانب كل مهارة Felo Skill أخرى متاحة. يكتشف المثبّت ديناميكيًا كل دليل حزمة يحتوي SKILL.md، لذا يشمل الإضافات المستقبلية. ثبّت كل المهارات المكتشفة في Codex ~/.codex/skills أو Claude Code ~/.claude/skills أو OpenClaw ~/.agents/skills أو Hermes Agent ~/.hermes/skills. اتبع دليل إعداد وكيل الذكاء الاصطناعي اليدوي لإجراء الإعداد الآمن على كل منصة.

إنشاء خريطة ذهنية

أنشئ خريطة ذهنية بناءً على استعلام (موضوع أو سؤال).

Endpoint

POST https://openapi.felo.ai/v2/mindmap

رؤوس الطلب

الرأس	مطلوب	الوصف
`Authorization`	نعم	مفتاح API الخاص بك بالصيغة `Bearer YOUR_API_KEY`
`Content-Type`	نعم	يجب أن يكون `application/json`

نص الطلب

المعامل	النوع	مطلوب	الوصف
`query`	string	نعم	الموضوع أو السؤال لتوليد الخريطة الذهنية. بحد أقصى 2000 حرف
`layout`	string	لا	نوع التخطيط. الافتراضي: `MIND_MAP`
`livedoc_short_id`	string	لا	معرّف LiveDoc. إذا لم يُقدَّم، يُنشأ LiveDoc جديد تلقائيًا

أنواع التخطيط

التخطيط	الوصف
`MIND_MAP`	خريطة ذهنية كلاسيكية (افتراضية)
`LOGICAL_STRUCTURE`	مخطط بنية منطقية
`ORGANIZATION_STRUCTURE`	مخطط تنظيمي
`CATALOG_ORGANIZATION`	مخطط تنظيمي بفهرس
`TIMELINE`	مخطط خط زمني
`FISHBONE`	مخطط عظمة السمكة

مثال: إنشاء مع LiveDoc تلقائي

curl -X POST 'https://openapi.felo.ai/v2/mindmap' \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "query": "Artificial Intelligence trends in 2024"
  }'

مثال: إنشاء مع LiveDoc محدد

curl -X POST 'https://openapi.felo.ai/v2/mindmap' \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "query": "Project timeline overview",
    "layout": "TIMELINE",
    "livedoc_short_id": "abc123xyz"
  }'

استجابة النجاح (200)

{
  "status": "ok",
  "message": null,
  "data": {
    "resource_id": "550e8400-e29b-41d4-a716-446655440000",
    "status": "COMPLETED",
    "livedoc_short_id": "PvyKouzJirXjFdst4uKRK3",
    "mindmap_url": "https://felo.ai/mindmap/550e8400-e29b-41d4-a716-446655440000",
    "svg": "<svg>...</svg>",
    "message": "Mindmap created successfully"
  }
}

حقول الاستجابة

الحقل	النوع	الوصف
`resource_id`	string	معرّف المورد للخريطة الذهنية المنشأة
`status`	string	حالة الخريطة الذهنية (مثل `COMPLETED`)
`livedoc_short_id`	string	معرّف LiveDoc المختصر حيث تُخزَّن الخريطة الذهنية
`mindmap_url`	string	عنوان URL لعرض الخريطة الذهنية (الصيغة: `{host}/mindmap/{resource_id}`)
`svg`	string	محتوى SVG للخريطة الذهنية
`message`	string	رسالة الحالة

رموز الأخطاء

الرمز	حالة HTTP	الوصف
`UNAUTHORIZED`	401	مفتاح API غير صالح أو مُبطَل
`MINDMAP_CREATE_FAILED`	502	فشل إنشاء الخريطة الذهنية
`LIVEDOC_CREATE_FAILED`	502	فشل إنشاء LiveDoc
`LIVEDOC_NOT_FOUND`	404	LiveDoc المحدد غير موجود
`LLM_SERVICE_UNAVAILABLE`	503	خدمة LLM غير متاحة
`LLM_REQUEST_TIMEOUT`	504	انتهت مهلة طلب LLM