Connecteur de table d'aération

Connecteur Airtable

Introduction

L'intégration Tulip-Airtable fournit un moyen facile d'intégrer Tulip avec des données existantes dans Airtable. L'API suit de près la sémantique REST, utilise JSON pour encoder les objets, et s'appuie sur les codes HTTP standard pour signaler les résultats des opérations. Le but de ce connecteur est d'intégrer Airtable avec Tulip en utilisant des connecteurs HTTP et de fournir à nos clients un connecteur Airtable prêt à l'emploi qui peut être importé dans leur instance.

Objectif

Nous allons mettre en évidence différentes fonctions de connecteur HTTP qui peuvent être construites en faisant des appels HTTP aux points d'extrémité de l'API Airtable pour interagir avec les tables Airtable dans un espace de travail afin d'essayer diverses actions de lecture et d'écriture sur les tables qui pourraient être exploitées pour divers cas d'utilisation. Nous explorerons l'utilisation du jeton OAuth Bearer et tirerons parti de l'utilisation de l'API.

Documentation API

Documentation API Airtable

Pré-requis

1. Créer un compte sur Airtable
2. Créer un nouvel espace de travail, et générer un jeton Bearer à utiliser dans les en-têtes de connexion.

Détails de la connexion Tulip

Les informations suivantes doivent être configurées sur les connecteurs de Tulip.

1. Exécution sur : Cloud Connector Host
2. Hôte :api.airtable.com
3. Port:443
4. TLS:Oui
5. OAuth 2(Bearer Token) : L'authentification sera transmise à toutes les fonctions du connecteur.

Fonctions du connecteur

Airtable Créer un enregistrement

Objectif

Cette fonction de connecteur crée un seul ou une liste d'enregistrements dans Airtable.

Le corps de votre demande doit inclure un tableau de 10 objets d'enregistrement au maximum. Chacun de ces objets doit avoir une clé, champs, qui contient toutes les valeurs de votre enregistrement par nom de champ. Vous pouvez inclure toutes les valeurs des champs, certaines d'entre elles ou aucune.

Point d'arrivée

Appel HTTP POST au point de terminaison https://api.airtable.com/v0/base_id/TableName

Données requises

Les paramètres à transmettre sont les suivants

1. Nom de la table (URL)
2. Un tableau d'objets transmis dans le corps de la requête pour la création d'enregistrements multiples.

Extracteur de sortie

1. Tableau d'objets
2. Chaque objet contient RecordId et d'autres champs de la table.

Suppression d'un enregistrement par Airtable

Objectif

Cette fonction de connecteur supprimera les données de Airtable avec l'identifiant d'enregistrement fourni. Les données seront supprimées de la table de façon permanente.

Point final

Appel HTTP DELETE au point de terminaison -https://api.airtable.com/v0/base_id/TableName

Données requises

Les paramètres URL à transmettre sont les suivants

1. Nom de la table
2. Id d'enregistrement

Airtable Get Record

Objectif

Cette fonction du connecteur permet d'obtenir un seul enregistrement d'Airtable avec l'identifiant d'enregistrement fourni. Grâce à ce connecteur, nous pouvons obtenir les données pour les modifier ou les utiliser en tant qu'entrées dans un autre connecteur.

Point d'arrivée

Appel HTTP GET au point de terminaison -https://api.airtable.com/v0/base_id/TableName

Données requises

Les paramètres URL à transmettre sont les suivants

1. Nom de la table
2. Id d'enregistrement

Extracteur de sortie

1. Tableau d'objets
2. Chaque objet contient l'identifiant de l'enregistrement et d'autres champs de la table.

Liste des enregistrements de la table aérienne

Objectif

Cette fonction du connecteur permet d'obtenir une liste d'enregistrements de Airtable, le nombre d'enregistrements étant défini par le paramètre de requête max records. Avec ce connecteur, nous pouvons obtenir les données pour les modifier ou les utiliser comme entrées dans un autre connecteur.

Point final

Appel HTTP GET au point de terminaison -https://api.airtable.com/v0/base_id/TableName

Données requises

Les paramètres à transmettre sont les suivants

1. Nom de la table (URL)
2. MaxRecords : Nombre spécifiant le nombre d'enregistrements à rechercher (paramètre de requête)

Sortie Extracteur

1. Tableau d'objets
2. Chaque objet contient RecordId et d'autres champs de la table.

Mise à jour de l'enregistrement par Airtable

Objectif

Cette fonction de connecteur met à jour un enregistrement dans Airtable.

Une requête PATCH ne mettra à jour que les champs que vous spécifiez, laissant les autres tels quels. Le connecteur prend le nom de la table, l'identifiant de l'enregistrement et la liste des valeurs à mettre à jour dans la table.

Point de terminaison

Appel HTTP Patch vers le point de terminaison -https://api.airtable.com/v0/base_id/TableName

Données requises

Les paramètres à transmettre sont les suivants

1. Nom de la table (URL)
2. Record Id (URL)
3. Valeurs mises à jour : les différentes colonnes à mettre à jour envoyées dans le corps de la requête.

Extracteur de sortie

1. Tableau d'objets
2. Chaque objet contient l'identifiant de l'enregistrement et d'autres champs du tableau.

Vidéo