Felo API PlatformFelo API Platform

Felo APIs

Mindmap API

Maak mindmaps op basis van prompts en optionele LiveDoc-context.

POST/v2/mindmap

Authenticatie

Bearer API key

Inhoudstype

application/json

Toelichting op limieten

Er kunnen limieten gelden die specifiek zijn voor het endpoint.

De Mindmap API biedt mogelijkheden om mindmaps te genereren. Je kunt een mindmap maken op basis van een onderwerp of vraag en optioneel een indeeltype opgeven.

Authenticatie

Alle verzoeken vereisen een API-sleutel in de Authorization-header:

Authorization: Bearer YOUR_API_KEY

Gebruik met AI-agents

Installeer het volledige pakket felo-ai om een agent mindmaps te laten maken naast alle andere beschikbare Felo Skills. Het installatieprogramma ontdekt dynamisch elke pakketmap die SKILL.md bevat, dus ook toekomstige toevoegingen. Installeer alle gevonden Skills in Codex ~/.codex/skills, Claude Code ~/.claude/skills, OpenClaw ~/.agents/skills of Hermes Agent ~/.hermes/skills. Volg de handleiding voor handmatige AI-agentconfiguratie voor de veilige installatieprocedure per platform.

Een mindmap maken

Maak een mindmap op basis van een query (onderwerp of vraag).

Endpoint

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

Verzoekheaders

HeaderVerplichtBeschrijving
AuthorizationJaJe API-sleutel in de vorm Bearer YOUR_API_KEY
Content-TypeJaMoet application/json zijn

Verzoekbody

ParameterTypeVerplichtBeschrijving
querystringJaHet onderwerp of de vraag voor het genereren van de mindmap. Maximaal 2000 tekens
layoutstringNeeIndeeltype. Standaard: MIND_MAP
livedoc_short_idstringNeeLiveDoc-ID. Als je dit niet opgeeft, wordt automatisch een nieuwe LiveDoc aangemaakt

Indeeltypen

IndelingBeschrijving
MIND_MAPKlassieke mindmap (standaard)
LOGICAL_STRUCTURELogisch structuurschema
ORGANIZATION_STRUCTUREOrganisatieschema
CATALOG_ORGANIZATIONCatalogusorganisatieschema
TIMELINETijdlijnschema
FISHBONEVisgraatschema

Voorbeeld: maken met automatische 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"
  }'

Voorbeeld: maken met een specifieke 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"
  }'

Succesrespons (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"
  }
}

Responsvelden

VeldTypeBeschrijving
resource_idstringResource-ID van de aangemaakte mindmap
statusstringStatus van de mindmap (bijvoorbeeld COMPLETED)
livedoc_short_idstringKorte LiveDoc-ID waarin de mindmap wordt opgeslagen
mindmap_urlstringURL om de mindmap te bekijken (vorm: {host}/mindmap/{resource_id})
svgstringSVG-inhoud van de mindmap
messagestringStatusbericht

Foutcodes

CodeHTTP-statusBeschrijving
UNAUTHORIZED401API-sleutel is ongeldig of ingetrokken
MINDMAP_CREATE_FAILED502Het maken van de mindmap is mislukt
LIVEDOC_CREATE_FAILED502Het maken van de LiveDoc is mislukt
LIVEDOC_NOT_FOUND404De opgegeven LiveDoc is niet gevonden
LLM_SERVICE_UNAVAILABLE503De LLM-service is niet beschikbaar
LLM_REQUEST_TIMEOUT504Er is een time-out opgetreden bij het LLM-verzoek