Référence de l'API Packages

La plupart des utilisateurs n'appellent pas cette API. La librairie @flocon-ai/next l'appelle pour vous.

Utilisez-la seulement pour construire votre propre intégration.

Bases

  • URL de base : https://api.flocon-ai.com
  • GET uniquement.
  • Auth : Authorization: Bearer <token du site web>. Seul le token du site web fonctionne. Un token absent, faux ou révoqué donne 401.
  • Si vous envoyez un token MCP, le message du 401 dit : « This is an MCP token. Your website needs the website token: https://flocon-ai.com/app/tokens ».
  • Un token = un website.
  • Pages publiées uniquement. Les brouillons et les pages programmées ne sortent jamais de cette API.
  • Les erreurs sont en JSON : { "message": "..." }.

GET /website

Le website du token. Aucun paramètre.

Renvoie :

  • name
  • defaultLocale
  • locales
  • badge : true si le badge Flocon AI doit être affiché (plan Free)

GET /pages

Toutes les pages servies, en version légère (sans blocs). Aucun paramètre.

Renvoie un tableau. Chaque entrée :

  • locale
  • path
  • title
  • updatedAt
  • alternates : les autres locales de cette page

GET /pages/{locale}/{path}

Une page publiée. Exemple : /pages/en/vs/notion donne la page au chemin /vs/notion en en.

Renvoie :

  • locale, path, title
  • alternates : les autres locales où cette page est publiée
  • seo
  • blocks : voir la référence des blocs. Dans un bloc related, les pages viennent avec leur path et leur title.
  • createdAt, updatedAt

Erreurs :

  • 404 : la page n'existe pas, ou c'est un brouillon, ou elle n'est pas encore publiée.

GET /doc

La description OpenAPI 3.0 de l'API. Publique : pas de token.

Mis à jour