Felo APIs

Mindmap API

צרו מפות חשיבה מפרומפטים ומהקשר LiveDoc אופציונלי.

POST/v2/mindmap

אימות

Bearer API key

סוג תוכן

application/json

הערות תעריף

ייתכנו מגבלות ספציפיות ל-endpoint.

LiveDoc API

ה-Mindmap API מספק יכולות יצירת מפות חשיבה. אפשר ליצור מפת חשיבה עם נושא או שאלה, ובאופן אופציונלי לציין סוג פריסה.

אימות

כל הבקשות דורשות מפתח API בכותרת Authorization:

Authorization: Bearer YOUR_API_KEY

שימוש עם סוכני AI

התקינו את החבילה המלאה felo-ai כדי לאפשר לסוכן ליצור מפות חשיבה לצד כל Felo Skill זמין אחר. המתקין מגלה באופן דינמי כל תיקיית חבילה שמכילה SKILL.md, כך שהוא כולל תוספות עתידיות. התקינו את כל ה-Skills שהתגלו ב-Codex ~/.codex/skills, Claude Code ~/.claude/skills, OpenClaw ~/.agents/skills או Hermes Agent ~/.hermes/skills. עקבו אחרי מדריך ההגדרה הידנית לסוכני AI להליך ההגדרה הבטוח בכל פלטפורמה.

יצירת מפת חשיבה

צרו מפת חשיבה על בסיס שאילתה (נושא או שאלה).

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