Passer au contenu principal
Craft devient plus flexible et puissant avec l’arrivée de notre API. Cette nouvelle capacité vous permet de connecter Craft à des outils externes, d’automatiser des flux de travail et de créer des intégrations personnalisées qui adaptent Craft à vos besoins.

Qu’est-ce qu’une API ?

Une API (Application Programming Interface) permet à différentes applications de communiquer entre elles de façon sécurisée. Concrètement, cela signifie que vous pouvez utiliser l’API de Craft pour :
  • Envoyer ou recevoir des données depuis d’autres services
  • Déclencher des actions dans Craft en fonction d’événements provenant d’une autre application
  • Créer des outils, tableaux de bord ou automatisations personnalisés
  • Connecter Craft à des assistants IA comme Claude ou ChatGPT via MCP ou d’autres méthodes d’intégration
Les API permettent à Craft de fonctionner de manière fluide avec les outils que vous utilisez déjà – sans copie manuelle ni tâches répétitives.

Comment fonctionne l’API de Craft

Créez une API Connection depuis l’onglet Imagine dans la sidebar pour partager les parties appropriées de votre espace de travail avec des outils externes. Vous pouvez choisir de :
  • Connecter toutes vos Notes quotidiennes, ou
  • Créer une connexion personnalisée où vous sélectionnez un ou plusieurs Document à inclure
Pour chaque connexion, vous définissez les permissions d’accès et la visibilité, afin de garder le contrôle sur ce qui est partagé. Craft génère alors un API endpoint unique pour cette connexion, que vous pouvez intégrer à vos outils ou flux basés sur des API. Ces outils n’auront accès qu’aux Documents que vous avez sélectionnés, tandis que le reste de votre Espace reste privé. Vous pouvez créer, consulter et gérer toutes vos connexions API dans Réglages de Craft → API Gestion des connexions API dans Réglages Après avoir créé une API Connection dans Craft, copiez l’API endpoint et les identifiants affichés dans l’onglet Imagine. Ensuite, rendez-vous dans l’application externe ou le flux que vous souhaitez connecter (par exemple un Assistant IA, un outil d’automatisation ou une configuration pour développeur) et ajoutez ces informations dans ses paramètres de connexion ou d’intégration API. Chaque outil procède un peu différemment, mais le principe est le même : collez les détails de l’API de Craft, et l’outil pourra accéder uniquement aux Documents sélectionnés pour cette connexion.
L’API de Craft prend désormais en charge l’accès complet au niveau de l’Espace avec des capacités avancées :
  • Recherche à travers tous les Document avec filtrage par dossier, Tag et date
  • Notes quotidiennes et Tâches entièrement accessibles via l’API
  • Créer, mettre à jour et supprimer des Document de manière programmatique
  • Gestion des Collections incluant la création et l’édition de schémas
  • Recherche avancée avec support regex et filtres de date prenant en compte le fuseau horaire
Consultez la documentation officielle de l’API pour les détails complets des endpoints.

Cas d’utilisation

Voici quelques exemples de ce que vous pouvez créer avec l’API :
  • Un tableau de bord personnel qui se met à jour automatiquement
  • Une liste de Tâches qui se synchronise avec une autre application de productivité
  • Un journal de lecture qui récupère des données depuis une source externe
  • Un Assistant IA personnalisé adapté à vos Documents Craft
  • La création automatique de Documents à partir de modèles
  • Sauvegardes ou exportations planifiées
  • Intégration avec des outils de communication d’équipe
Les possibilités sont vastes – l’API vous permet d’étendre Craft comme vous l’imaginez.

Guides complets et documentation

Tous les guides étape par étape pour l’API, les connexions MCP et les intégrations d’exemple (y compris Claude et ChatGPT) sont disponibles ici : 👉 https://www.craft.do/imagine/ C’est la meilleure ressource pour explorer des tutoriels, apprendre comment activer MCP et comprendre comment connecter Craft à des outils tiers. Si vous avez besoin d’aide pour commencer ou si vous avez des questions, n’hésitez pas à nous contacter – nous sommes là pour vous aider.