Felo API PlatformFelo API Platform

Felo APIs

Mindmap API

Bir istemden ve isteğe bağlı LiveDoc bağlamından zihin haritaları oluşturun.

POST/v2/mindmap

Kimlik doğrulama

Bearer API key

İçerik türü

application/json

Hız sınırı notları

Endpoint bazında sınırlar geçerli olabilir.

Mindmap API, mindmap oluşturma yetenekleri sunar. Bir konu veya soruyla mindmap oluşturabilir ve isteğe bağlı olarak bir düzen türü belirtebilirsiniz.

Kimlik Doğrulama

Tüm istekler, Authorization başlığında bir API anahtarı gerektirir:

Authorization: Bearer YOUR_API_KEY

AI Ajanlarıyla Kullanım

Bir Ajanın diğer tüm mevcut Felo Skill'leriyle birlikte mindmap oluşturması için eksiksiz felo-ai paketini yükleyin. Yükleyici, SKILL.md içeren her paket dizinini dinamik olarak keşfeder; böylece gelecekteki eklemeleri de kapsar. Keşfedilen tüm Skill'leri Codex ~/.codex/skills, Claude Code ~/.claude/skills, OpenClaw ~/.agents/skills veya Hermes Agent ~/.hermes/skills dizinlerine yükleyin. Her platform için güvenli kurulum prosedürüne ilişkin manuel AI Ajanı kurulum kılavuzunu izleyin.

Mindmap Oluşturma

Bir sorguya (konu veya soru) dayalı olarak mindmap oluşturun.

Endpoint

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

İstek Başlıkları

BaşlıkGerekliAçıklama
AuthorizationEvetBearer YOUR_API_KEY biçimindeki API anahtarınız
Content-TypeEvetapplication/json olmalıdır

İstek Gövdesi

ParametreTürGerekliAçıklama
querystringEvetMindmap oluşturma için konu veya soru. En fazla 2000 karakter
layoutstringHayırDüzen türü. Varsayılan: MIND_MAP
livedoc_short_idstringHayırLiveDoc kimliği. Sağlanmazsa otomatik olarak yeni bir LiveDoc oluşturulur

Düzen Türleri

DüzenAçıklama
MIND_MAPKlasik mind map (varsayılan)
LOGICAL_STRUCTUREMantıksal yapı diyagramı
ORGANIZATION_STRUCTUREOrganizasyon şeması
CATALOG_ORGANIZATIONKatalog organizasyon şeması
TIMELINEZaman çizelgesi diyagramı
FISHBONEBalık kılçığı diyagramı

Örnek: Otomatik LiveDoc ile Oluşturma

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"
  }'

Örnek: Belirli LiveDoc ile Oluşturma

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"
  }'

Başarılı Yanıt (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"
  }
}

Yanıt Alanları

AlanTürAçıklama
resource_idstringOluşturulan mindmap'in kaynak kimliği
statusstringMindmap'in durumu (ör. COMPLETED)
livedoc_short_idstringMindmap'in saklandığı LiveDoc kısa kimliği
mindmap_urlstringMindmap'i görüntülemek için URL (biçim: {host}/mindmap/{resource_id})
svgstringMindmap'in SVG içeriği
messagestringDurum mesajı

Hata Kodları

KodHTTP DurumuAçıklama
UNAUTHORIZED401API anahtarı geçersiz veya iptal edilmiş
MINDMAP_CREATE_FAILED502Mindmap oluşturulamadı
LIVEDOC_CREATE_FAILED502LiveDoc oluşturulamadı
LIVEDOC_NOT_FOUND404Belirtilen LiveDoc bulunamadı
LLM_SERVICE_UNAVAILABLE503LLM hizmeti kullanılamıyor
LLM_REQUEST_TIMEOUT504LLM isteği zaman aşımına uğradı