Se connecter à Airtable

Connectez simplement votre application à une base Airtable pour récupérer et envoyer des données.

Créer un compte gratuit sur Airtable 

Airtable est un outil très connu mêlant tableur, base de données et gestion de projet. Airtable permet facilement de gérer de manière hybride un grand nombre de données, et pas seulement des chiffres : numéro de téléphone, dates, code-barres, photos... Son utilisation simple, intuitive et souvent gratuite en fait un outil incontournable de l'écosystème no code. 

Pour créer un compte gratuit sur Airtable : https://airtable.com/signup

Préparer votre base Airtable

Créez une nouvelle base de données en cliquant sur  Add a base.

Structurez vos données au sein d'une table en ajoutant des champs ( Fields) pour chaque type de donnée. 

Voici l'exemple d'une base de biens immobiliers : 

Vous avez plusieurs types de champs ( Field type) : checkbox, texte, date, image etc...

Importez vos données manuellement ou via un fichier .csv, Microsoft Excel ou Google Sheets : 

Créer un jeton personnel (token)

Depuis 2024, Airtable a renforcé ses règles de sécurité et vous invite à créer un jeton personnel (token) pour vos connexions API.

Pour créer un jeton personnel : 

• Rendez-vous dans l'espace dédié de votre compte Airtable : https://airtable.com/create/tokens
• Cliquer sur le bouton Create token
• Choisissez un Nom, un périmètre Scope et une base associée. Si vous souhaitez afficher des données, choisissez Read.

• Votre jeton personnel est prêt à être utilisé. Copiez-collez le dans un endroit sécurisé.

Configurer le composant HTTP

Connectez votre base Airtable à votre application PandaSuite grâce au composant HTTP.

Pour configurer votre composant HTTP :

• Sélectionnez votre Projet : en le plaçant à cet endroit, votre composant sera accessible tout au long de votre application
• Cliquez sur Composants >  HTTP.

• Saisissez les propriétés correspondant à votre base et votre compte Airtable. Retrouvez les paramètres de l'API Airtable que vous trouvez dans  HELP > API Documentation.

URL

Pour récupérer l'URL de l'API, sélectionnez votre  Table sur la gauche et cliquez sur List Records. 

Copiez-collez l'URL de l'API. Voici un exemple d'URL : 

https://api.airtable.com/v0/appIGPMYLUbwWCCbZ/Table%201

💡 Copiez tout ce qui se situe depuis le  https: jusqu'au "?" sans inclure le "?". Le reste des informations correspond à des Chaînes d'interrogation / Query String qui seront spécifiés plus bas

Jeton personnel (token)

Pour ajouter votre jeton personnel (token) dans votre composant :

• Dans le champ En-tête, cliquez sur + Ajouter. 
• Ajoutez  Authorization comme clé et Bearer TOKEN comme valeur. Remplacez TOKEN par votre jeton personnel. 

Méthode

Pour requêter de la donnée, sélectionnez la méthode  GET. Si vous souhaitez en envoyer, choisissez la méthode POST.

Gestion du cache 

La mise en cache vous permet de réutiliser efficacement des données de l'API précédemment récupérées ou traitées, et gérer la disponibilité de ces données sans connexion Internet. 

Choisissez parmi les options suivantes : 

• Aucun cache : l'application fera un appel réseau et ne lira pas le cache
• Cache en premier : l'application recherche le résultat dans le cache avant de faire une requête au réseau.
• Réseau et cache : l'application retournera le contenu du cache mais fera tout de même la requête afin de le mettre à jour. Cette option permet d’avoir une réponse rapide.

L'option  Cache persistant permet de conserver le cache même après la fermeture de l'application.

Tester la requête 

Vérifiez que tout fonctionne correctement et que les données sont bien remontées depuis Airtable.

Double-cliquez sur le composant HTTP dans la liste des Objets. Cliquez sur le bouton  Test Request pour lancer une requête.

Les résultats de votre requête apparaissent : si les données brutes s'affichent, l'API a été correctement configurée. Vous visualisez la manière dont vos données sont structurées et PandaSuite Studio est ensuite en capacité de vous montrer visuellement vos données dans l'explorateur de la fenêtre de data binding. 

Vos données Airtable sont prêtes à être utilisées dans votre application.