Felo APIs
Mindmap API
Bir istemden ve isteğe bağlı LiveDoc bağlamından zihin haritaları oluşturun.
/v2/mindmapKimlik 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_KEYAI 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ık | Gerekli | Açıklama |
|---|---|---|
Authorization | Evet | Bearer YOUR_API_KEY biçimindeki API anahtarınız |
Content-Type | Evet | application/json olmalıdır |
İstek Gövdesi
| Parametre | Tür | Gerekli | Açıklama |
|---|---|---|---|
query | string | Evet | Mindmap oluşturma için konu veya soru. En fazla 2000 karakter |
layout | string | Hayır | Düzen türü. Varsayılan: MIND_MAP |
livedoc_short_id | string | Hayır | LiveDoc kimliği. Sağlanmazsa otomatik olarak yeni bir LiveDoc oluşturulur |
Düzen Türleri
| Düzen | Açıklama |
|---|---|
MIND_MAP | Klasik mind map (varsayılan) |
LOGICAL_STRUCTURE | Mantıksal yapı diyagramı |
ORGANIZATION_STRUCTURE | Organizasyon şeması |
CATALOG_ORGANIZATION | Katalog organizasyon şeması |
TIMELINE | Zaman çizelgesi diyagramı |
FISHBONE | Balı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ı
| Alan | Tür | Açıklama |
|---|---|---|
resource_id | string | Oluşturulan mindmap'in kaynak kimliği |
status | string | Mindmap'in durumu (ör. COMPLETED) |
livedoc_short_id | string | Mindmap'in saklandığı LiveDoc kısa kimliği |
mindmap_url | string | Mindmap'i görüntülemek için URL (biçim: {host}/mindmap/{resource_id}) |
svg | string | Mindmap'in SVG içeriği |
message | string | Durum mesajı |
Hata Kodları
| Kod | HTTP Durumu | Açıklama |
|---|---|---|
UNAUTHORIZED | 401 | API anahtarı geçersiz veya iptal edilmiş |
MINDMAP_CREATE_FAILED | 502 | Mindmap oluşturulamadı |
LIVEDOC_CREATE_FAILED | 502 | LiveDoc oluşturulamadı |
LIVEDOC_NOT_FOUND | 404 | Belirtilen LiveDoc bulunamadı |
LLM_SERVICE_UNAVAILABLE | 503 | LLM hizmeti kullanılamıyor |
LLM_REQUEST_TIMEOUT | 504 | LLM isteği zaman aşımına uğradı |