Felo APIs

Mindmap API

Créez des mindmaps à partir de prompts et d'un contexte LiveDoc facultatif.

POST/v2/mindmap

Authentification

Bearer API key

Type de contenu

application/json

Notes sur les limites

Des limites propres à l'endpoint peuvent s'appliquer.

LiveDoc API

L'API Mindmap fournit des capacités de génération de mindmaps. Vous pouvez créer une mindmap à partir d'un sujet ou d'une question et, en option, spécifier un type de disposition.

Authentification

Toutes les requêtes nécessitent une clé API dans l'en-tête Authorization :

Authorization: Bearer YOUR_API_KEY

Utilisation avec des agents IA

Installez le paquet complet felo-ai pour permettre à un agent de créer des mindmaps aux côtés de tous les autres Felo Skills disponibles. L'installateur découvre dynamiquement chaque répertoire de paquet contenant SKILL.md, ce qui inclut les ajouts futurs. Installez tous les Skills découverts dans Codex ~/.codex/skills, Claude Code ~/.claude/skills, OpenClaw ~/.agents/skills ou Hermes Agent ~/.hermes/skills. Suivez le guide d'installation manuelle des agents IA pour la procédure d'installation sûre de chaque plateforme.

Créer une mindmap

Créez une mindmap à partir d'une requête (sujet ou question).

Endpoint

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

En-têtes de requête

En-tête	Requis	Description
`Authorization`	Oui	Votre clé API au format `Bearer YOUR_API_KEY`
`Content-Type`	Oui	Doit être `application/json`

Corps de requête

Paramètre	Type	Requis	Description
`query`	string	Oui	Le sujet ou la question pour la génération de la mindmap. 2000 caractères maximum
`layout`	string	Non	Type de disposition. Par défaut : `MIND_MAP`
`livedoc_short_id`	string	Non	ID LiveDoc. S'il n'est pas fourni, un nouveau LiveDoc sera créé automatiquement

Types de disposition

Disposition	Description
`MIND_MAP`	Mind map classique (par défaut)
`LOGICAL_STRUCTURE`	Diagramme de structure logique
`ORGANIZATION_STRUCTURE`	Organigramme
`CATALOG_ORGANIZATION`	Organigramme de catalogue
`TIMELINE`	Diagramme de chronologie
`FISHBONE`	Diagramme en arête de poisson

Exemple : création avec LiveDoc automatique

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

Exemple : création avec un LiveDoc spécifique

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

Réponse de succès (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"
  }
}

Champs de réponse

Champ	Type	Description
`resource_id`	string	ID de ressource de la mindmap créée
`status`	string	Statut de la mindmap (par exemple `COMPLETED`)
`livedoc_short_id`	string	ID court du LiveDoc où la mindmap est stockée
`mindmap_url`	string	URL pour consulter la mindmap (format : `{host}/mindmap/{resource_id}`)
`svg`	string	Contenu SVG de la mindmap
`message`	string	Message de statut

Codes d'erreur

Code	Statut HTTP	Description
`UNAUTHORIZED`	401	La clé API est invalide ou révoquée
`MINDMAP_CREATE_FAILED`	502	La création de la mindmap a échoué
`LIVEDOC_CREATE_FAILED`	502	La création du LiveDoc a échoué
`LIVEDOC_NOT_FOUND`	404	Le LiveDoc spécifié est introuvable
`LLM_SERVICE_UNAVAILABLE`	503	Le service LLM est indisponible
`LLM_REQUEST_TIMEOUT`	504	Le délai de la requête LLM a expiré