Felo APIs
Mindmap API
Maak mindmaps op basis van prompts en optionele LiveDoc-context.
/v2/mindmapAuthenticatie
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_KEYGebruik 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/mindmapVerzoekheaders
| Header | Verplicht | Beschrijving |
|---|---|---|
Authorization | Ja | Je API-sleutel in de vorm Bearer YOUR_API_KEY |
Content-Type | Ja | Moet application/json zijn |
Verzoekbody
| Parameter | Type | Verplicht | Beschrijving |
|---|---|---|---|
query | string | Ja | Het onderwerp of de vraag voor het genereren van de mindmap. Maximaal 2000 tekens |
layout | string | Nee | Indeeltype. Standaard: MIND_MAP |
livedoc_short_id | string | Nee | LiveDoc-ID. Als je dit niet opgeeft, wordt automatisch een nieuwe LiveDoc aangemaakt |
Indeeltypen
| Indeling | Beschrijving |
|---|---|
MIND_MAP | Klassieke mindmap (standaard) |
LOGICAL_STRUCTURE | Logisch structuurschema |
ORGANIZATION_STRUCTURE | Organisatieschema |
CATALOG_ORGANIZATION | Catalogusorganisatieschema |
TIMELINE | Tijdlijnschema |
FISHBONE | Visgraatschema |
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
| Veld | Type | Beschrijving |
|---|---|---|
resource_id | string | Resource-ID van de aangemaakte mindmap |
status | string | Status van de mindmap (bijvoorbeeld COMPLETED) |
livedoc_short_id | string | Korte LiveDoc-ID waarin de mindmap wordt opgeslagen |
mindmap_url | string | URL om de mindmap te bekijken (vorm: {host}/mindmap/{resource_id}) |
svg | string | SVG-inhoud van de mindmap |
message | string | Statusbericht |
Foutcodes
| Code | HTTP-status | Beschrijving |
|---|---|---|
UNAUTHORIZED | 401 | API-sleutel is ongeldig of ingetrokken |
MINDMAP_CREATE_FAILED | 502 | Het maken van de mindmap is mislukt |
LIVEDOC_CREATE_FAILED | 502 | Het maken van de LiveDoc is mislukt |
LIVEDOC_NOT_FOUND | 404 | De opgegeven LiveDoc is niet gevonden |
LLM_SERVICE_UNAVAILABLE | 503 | De LLM-service is niet beschikbaar |
LLM_REQUEST_TIMEOUT | 504 | Er is een time-out opgetreden bij het LLM-verzoek |