Passer au contenu principal
Le schéma d’URL permet aux utilisateurs et aux développeurs d’autres applications d’envoyer des commandes à Craft. Cette page explique son fonctionnement et les capacités actuellement disponibles.
Nous prévoyons d’ajouter de nouvelles fonctionnalités aux capacités existantes à l’avenir.

​
Commandes disponibles

Voici les commandes prises en charge par Craft :
  • Ouvrir un Document
  • Créer un Document
  • Ajouter du contenu à un Document existant
  • Lancer une recherche dans un Espace
  • Accéder à Notes quotidiennes

​
Ouvrir une page

Entrées :
  • blockId – Vous pouvez y accéder si vous cliquez sur Copy Deeplink dans un Document, le lien contient un paramètre blockId
  • spaceId – Votre identifiant utilisateur en général (GUID aléatoire) ; si c’est un Espace partagé, vous devez l’obtenir en cliquant sur Copy Deeplink
Exemple : 
craftdocs://open?spaceId=<spaceId>&blockId=<blockId>
Cela ne fonctionne pas si vous n’êtes pas membre de l’Espace.

​
Ouvrir un Espace

Entrées :
  • spaceId – Vous pouvez l’obtenir à partir d’un deeplink simple, en cliquant sur Copy Deeplink
  • (optionnel) tab – calendar ou search ou documents
Exemple : 
craftdocs://openspace?spaceId=<spaceId>&tab=<tab>
Cela ne fonctionne pas si vous n’êtes pas membre de l’Espace.

​
Créer un nouveau Document vide

Entrée : Utilisez simplement cette URL pour créer un nouveau Document vide dans l’Espace actuellement ouvert : 
craftdocs://createnewdocument

​
Créer un Document

Entrées :
  • spaceId – Vous pouvez l’obtenir à partir d’un deeplink simple, en cliquant sur Copy Deeplink
  • content – Markdown encodé en pourcentage (les images ne sont pas encore prises en charge)
  • title – Titre en texte brut encodé en pourcentage
  • folderId – Le paramètre est requis, mais peut être vide
Exemple : 
craftdocs://createdocument?spaceId=<spaceId>&title=<title>&content=<content>&folderId=<folderId>

​
Ajouter à un Document

Entrées :
  • spaceId – Vous pouvez l’obtenir à partir d’un deeplink simple, en cliquant sur Copy Deeplink
  • index – Index du nouveau Bloc (0 pour insérer en tête, un nombre très grand pour ajouter à la fin – supérieur au nombre de Blocs présents dans votre Document)
  • parentBlockId – blockId du Document
  • content – Chaîne encodée en pourcentage
Exemple : 
craftdocs://createblock?parentBlockId=<parentBlockId>&spaceId=<spaceId>&content=<content>&index=<index>

​
Rechercher dans un Espace

Démarre une recherche dans un Espace donné et préremplit le champ de recherche avec le contenu de la requête. Entrées :
  • spaceId – Vous pouvez l’obtenir à partir d’un deeplink simple, en cliquant sur Copy Deeplink
  • query – Assurez-vous qu’elle est encodée en pourcentage
Exemple : 
craftdocs://opensearch?spaceId=<spaceId>&query=<query>

​
Accès à Notes quotidiennes

  • Hier – craftdocs://openByQuery?query=yesterday&spaceId=<spaceId>
  • Aujourd’hui – craftdocs://openByQuery?query=today&spaceId=<spaceId>
  • Demain – craftdocs://openByQuery?query=tomorrow&spaceId=<spaceId>

​
Articles connexes

Craft API

iOS Shortcuts

Deeplinks (Guide utilisateur)