Felo APIs

Mindmap API

Cipta mindmap daripada prompt dan konteks LiveDoc pilihan.

POST/v2/mindmap

Pengesahan

Bearer API key

Jenis kandungan

application/json

Nota had kadar

Had khusus endpoint mungkin terpakai.

LiveDoc API

Mindmap API menyediakan keupayaan penjanaan peta minda. Anda boleh mencipta peta minda dengan topik atau soalan, dan secara pilihan menentukan jenis susun atur.

Pengesahan

Semua permintaan memerlukan Kunci API dalam pengepala Authorization:

Authorization: Bearer YOUR_API_KEY

Guna dengan Ejen AI

Pasang pakej lengkap felo-ai untuk membolehkan Ejen mencipta peta minda bersama setiap Felo Skill lain yang tersedia. Pemasang menemui secara dinamik setiap direktori pakej yang mengandungi SKILL.md, jadi ia merangkumi penambahan pada masa hadapan. Pasang semua Skill yang ditemui dalam ~/.codex/skills Codex, ~/.claude/skills Claude Code, ~/.agents/skills OpenClaw, atau ~/.hermes/skills Hermes Agent. Ikuti panduan persediaan Ejen AI manual untuk prosedur persediaan yang selamat bagi setiap platform.

Cipta Peta Minda

Cipta peta minda berdasarkan pertanyaan (topik atau soalan).

Endpoint

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

Pengepala Permintaan

Pengepala	Wajib	Penerangan
`Authorization`	Ya	Kunci API anda dalam format `Bearer YOUR_API_KEY`
`Content-Type`	Ya	Mesti `application/json`

Isi Badan Permintaan

Parameter	Jenis	Wajib	Penerangan
`query`	string	Ya	Topik atau soalan untuk penjanaan peta minda. Maksimum 2000 aksara
`layout`	string	Tidak	Jenis susun atur. Lalai: `MIND_MAP`
`livedoc_short_id`	string	Tidak	ID LiveDoc. Jika tidak diberikan, LiveDoc baharu akan dicipta secara automatik

Jenis Susun Atur

Susun atur	Penerangan
`MIND_MAP`	Peta minda klasik (lalai)
`LOGICAL_STRUCTURE`	Gambar rajah struktur logik
`ORGANIZATION_STRUCTURE`	Carta organisasi
`CATALOG_ORGANIZATION`	Carta organisasi katalog
`TIMELINE`	Gambar rajah garis masa
`FISHBONE`	Gambar rajah tulang ikan

Contoh: Cipta dengan LiveDoc Automatik

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

Contoh: Cipta dengan LiveDoc Tertentu

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

Respons Berjaya (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"
  }
}

Medan Respons

Medan	Jenis	Penerangan
`resource_id`	string	ID sumber peta minda yang dicipta
`status`	string	Status peta minda (contohnya, `COMPLETED`)
`livedoc_short_id`	string	ID pendek LiveDoc tempat peta minda disimpan
`mindmap_url`	string	URL untuk melihat peta minda (format: `{host}/mindmap/{resource_id}`)
`svg`	string	Kandungan SVG peta minda
`message`	string	Mesej status

Kod Ralat

Kod	Status HTTP	Penerangan
`UNAUTHORIZED`	401	Kunci API tidak sah atau telah dibatalkan
`MINDMAP_CREATE_FAILED`	502	Penciptaan peta minda gagal
`LIVEDOC_CREATE_FAILED`	502	Gagal mencipta LiveDoc
`LIVEDOC_NOT_FOUND`	404	LiveDoc yang ditentukan tidak ditemui
`LLM_SERVICE_UNAVAILABLE`	503	Perkhidmatan LLM tidak tersedia
`LLM_REQUEST_TIMEOUT`	504	Permintaan LLM tamat masa