Felo APIs
Mindmap API
Crea mappe mentali da prompt e da contesto LiveDoc opzionale.
/v2/mindmapAutenticazione
Bearer API key
Tipo di contenuto
application/json
Note sui limiti
Possono applicarsi limiti specifici dell'endpoint.
La Mindmap API offre capacità di generazione di mappe mentali. Puoi creare una mappa mentale con un argomento o una domanda e, facoltativamente, specificare un tipo di layout.
Autenticazione
Tutte le richieste richiedono una chiave API nell'header Authorization:
Authorization: Bearer YOUR_API_KEYUso con agenti IA
Installa il pacchetto completo felo-ai per permettere a un agente di creare mappe mentali insieme a ogni altra Felo Skill disponibile. L'installer individua dinamicamente ogni directory del pacchetto che contiene SKILL.md, quindi include anche le aggiunte future. Installa tutte le Skill trovate in Codex ~/.codex/skills, Claude Code ~/.claude/skills, OpenClaw ~/.agents/skills o Hermes Agent ~/.hermes/skills. Segui la guida alla configurazione manuale degli agenti IA per la procedura sicura su ogni piattaforma.
Creare una mappa mentale
Crea una mappa mentale basata su una query (argomento o domanda).
Endpoint
POST https://openapi.felo.ai/v2/mindmapHeader della richiesta
| Header | Obbligatorio | Descrizione |
|---|---|---|
Authorization | Sì | La tua chiave API nel formato Bearer YOUR_API_KEY |
Content-Type | Sì | Deve essere application/json |
Corpo della richiesta
| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
query | string | Sì | L'argomento o la domanda per la generazione della mappa mentale. Massimo 2000 caratteri |
layout | string | No | Tipo di layout. Predefinito: MIND_MAP |
livedoc_short_id | string | No | ID del LiveDoc. Se non viene fornito, viene creato automaticamente un nuovo LiveDoc |
Tipi di layout
| Layout | Descrizione |
|---|---|
MIND_MAP | Mappa mentale classica (predefinita) |
LOGICAL_STRUCTURE | Diagramma a struttura logica |
ORGANIZATION_STRUCTURE | Organigramma |
CATALOG_ORGANIZATION | Organigramma a catalogo |
TIMELINE | Diagramma temporale |
FISHBONE | Diagramma a lisca di pesce |
Esempio: creare con LiveDoc automatico
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"
}'Esempio: creare con un LiveDoc specifico
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"
}'Risposta di successo (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"
}
}Campi della risposta
| Campo | Tipo | Descrizione |
|---|---|---|
resource_id | string | ID risorsa della mappa mentale creata |
status | string | Stato della mappa mentale (ad es. COMPLETED) |
livedoc_short_id | string | ID breve del LiveDoc in cui è salvata la mappa mentale |
mindmap_url | string | URL per visualizzare la mappa mentale (formato: {host}/mindmap/{resource_id}) |
svg | string | Contenuto SVG della mappa mentale |
message | string | Messaggio di stato |
Codici di errore
| Codice | Stato HTTP | Descrizione |
|---|---|---|
UNAUTHORIZED | 401 | La chiave API non è valida o è revocata |
MINDMAP_CREATE_FAILED | 502 | Creazione della mappa mentale non riuscita |
LIVEDOC_CREATE_FAILED | 502 | Creazione del LiveDoc non riuscita |
LIVEDOC_NOT_FOUND | 404 | LiveDoc specificato non trovato |
LLM_SERVICE_UNAVAILABLE | 503 | Il servizio LLM non è disponibile |
LLM_REQUEST_TIMEOUT | 504 | Timeout della richiesta LLM |