Note API Connector

Ce qui définit l'outil, c'est son étendue, et c'est ce qui en fait une véritable intégration API sans code plutôt qu'un module pour une seule application. Vous collez un endpoint, définissez la requête et la réponse entre dans Notion, si bien que YouTube, Stripe, Shopify, Mailchimp, les API Google et des milliers d'autres fonctionnent de la même façon. Il ne se limite pas à une poignée de préréglages, et c'est là la différence avec une intégration mono-application. Si un service dispose d'une API, vous pouvez le connecter.

Avant d'importer, vous prévisualisez la réponse puis mappez chaque champ de l'API vers une propriété Notion à l'aide d'un éditeur visuel. Cela compte parce que la sortie brute d'une API correspond rarement à l'allure que vous voulez donner à votre base. Vous décidez de ce qui passe et de la façon dont ça arrive, ce qui vous épargne le nettoyage qu'impose toujours un import manuel. Les offres payantes relèvent le plafond de champs de réponse que vous pouvez mapper.

Vous pouvez lancer une requête à la main ou la laisser se répéter. Les planifications démarrent toutes les heures avec l'offre Starter et se resserrent à 15 minutes avec Business et à 5 minutes avec Enterprise. Cette plage couvre aussi bien un rapport quotidien qu'un flux de prix quasi temps réel. On la règle une fois et la base se maintient seule à jour, ce qui sépare un import ponctuel d'un import vivant.

À mesure que les données arrivent, vous pouvez demander à l'outil de créer des relations entre bases de données. Une ligne de produit se relie à son fournisseur, un événement à ses participants, une campagne à ses résultats. Le faire à la main dans Notion est lent et propice aux erreurs. Créer les liens pendant l'import garde les enregistrements liés connectés dès le départ, sans passe supplémentaire ensuite.

Les API qui renvoient des milliers de lignes sont gérées en suivant automatiquement les liens de page suivante. Vous pouvez le laisser récupérer tous les résultats ou vous arrêter où vous le décidez. C'est ce qui rend l'outil utile pour un catalogue entier ou un long historique, pas seulement pour un échantillon rapide. Sans prise en charge de la pagination, la plupart des jeux de données réels arriveraient à moitié.

Vous vous connectez à une API via OAuth, un jeton de porteur ou une authentification basique, et vous l'approuvez une fois. Ensuite, vous réutilisez la même connexion à chaque requête, donc vous ne collez pas vos identifiants en boucle. La prise en charge des styles d'authentification courants permet d'atteindre des endpoints privés, pas seulement publics, sans exposer les clés là où il ne faut pas.