Airtable-Anschluss

Airtable-Anschluss

Einführung

Die Tulip-Airtable-Integration bietet eine einfache Möglichkeit zur Integration von Tulip mit bestehenden Daten in Airtable. Die API ist eng an die REST-Semantik angelehnt, verwendet JSON zur Kodierung von Objekten und stützt sich auf Standard-HTTP-Codes zur Signalisierung von Operationsergebnissen. Das Ziel dieses Konnektors ist es, Airtable mit Tulip über HTTP-Konnektoren zu integrieren und unseren Kunden einen fertigen Airtable-Konnektor zu bieten, der in ihre Instanz importiert werden kann.

Zweck

Wir werden verschiedene HTTP-Connector-Funktionen aufzeigen, die durch HTTP-Aufrufe an Airtable-API-Endpunkte erstellt werden können, um mit den Airtables innerhalb eines Arbeitsbereichs zu interagieren und verschiedene Lese- und Schreibaktionen auf den Tabellen auszuprobieren, die für verschiedene Anwendungsfälle genutzt werden können. Wir werden die Verwendung von OAuth Bearer Token untersuchen und die Vorteile von

API-Dokument

Airtable-API-Dokumentation

Vorraussetzungen

1. Erstellen Sie ein Konto bei Airtable
2. Erstellen Sie einen neuen Arbeitsbereich und generieren Sie ein Bearer-Token, das als Teil der Verbindungs-Header verwendet werden soll.

Tulip-Verbindungsdetails

Die folgenden Informationen müssen für die Tulip-Konnektoren konfiguriert werden.

1. Läuft auf: Cloud Connector Host
2. Rechner :api.airtable.com
3. Anschluss:443
4. TLS:Ja
5. OAuth 2(Bearer Token): Die Authentifizierung wird an alle Connector-Funktionen weitergegeben.

Konnektor-Funktionen

Airtable Datensatz erstellen

Zweck

Diese Konnektorfunktion erstellt entweder einen einzelnen Datensatz oder eine Liste von Datensätzen in Airtable.

Ihr Anfragekörper sollte ein Array von bis zu 10 Datensatzobjekten enthalten. Jedes dieser Objekte sollte einen Schlüssel, fields, haben, der alle Werte Ihres Datensatzes nach Feldnamen enthält. Sie können alle, einige oder keinen der Feldwerte einschließen.

Endpunkt

HTTP POST-Aufruf an den Endpunkt https://api.airtable.com/v0/base_id/TableName

Erforderliche Eingabe

Die folgenden Parameter sind zu übergeben

1. Tabellenname (URL)
2. Ein Array von Objekten, das als Request Body zum Erstellen mehrerer Datensätze übergeben wird

Ausgabe Extraktor

1. Array von Objekten
2. Jedes Objekt hat RecordId, und andere Felder der Tabelle

Airtable Datensatz löschen

Zweck

Diese Konnektorfunktion löscht die Daten aus Airtable mit der angegebenen record_id. Die Daten werden dauerhaft aus der Tabelle gelöscht.

Endpunkt

HTTP DELETE Aufruf an den Endpunkt -https://api.airtable.com/v0/base_id/TableName

Erforderliche Eingabe

Die folgenden URL-Parameter sind zu übergeben

1. Name der Tabelle
2. Datensatz-ID

Airtable Datensatz abrufen

Zweck

Diese Konnektorfunktion ruft einen einzelnen Datensatz von Airtable mit der angegebenen Record Id ab. Mit diesem Konnektor können wir die Daten abrufen, um sie zu ändern oder als Input für einen anderen Konnektor zu verwenden.

Endpunkt

HTTP GET-Aufruf an den Endpunkt -https://api.airtable.com/v0/base_id/TableName

Erforderliche Eingabe

Die folgenden URL-Parameter sind zu übergeben

1. Tabellenname
2. Datensatz-ID

Ausgabe Extraktor

1. Array von Objekten
2. Jedes Objekt hatte RecordId, und andere Felder der Tabelle

Airtable Liste Datensätze

Zweck

Diese Konnektorfunktion ruft eine Liste von Datensätzen aus Airtable ab. Die Anzahl der Datensätze wird durch den Abfrageparameter max records definiert. Mit diesem Konnektor können wir die Daten erhalten, um sie zu ändern oder als Input für einen anderen Konnektor zu verwenden.

Endpunkt

HTTP GET-Aufruf an den Endpunkt -https://api.airtable.com/v0/base_id/TableName

Erforderliche Eingabe

Die folgenden Parameter sind zu übergeben

1. Tabellenname (URL)
2. MaxRecords: Zahl, die die Anzahl der abzurufenden Datensätze angibt (Abfrageparameter)

Ausgabe Extraktor

1. Array von Objekten
2. Jedes Objekt hatte RecordId und andere Felder der Tabelle

Airtable Datensatz aktualisieren

Zweck

Diese Connector-Funktion aktualisiert einen Datensatz in Airtable.

Eine PATCH-Anfrage aktualisiert nur die Felder, die Sie angeben, und lässt den Rest unverändert. Der Connector nimmt den Tabellennamen, die RecordId und die Liste der zu aktualisierenden Werte in der Tabelle entgegen.

Endpunkt

HTTP-Patch-Aufruf an den Endpunkt -https://api.airtable.com/v0/base_id/TableName

Erforderliche Eingaben

Die folgenden Parameter sind zu übergeben

1. Tabellenname (URL)
2. Datensatz-ID (URL)
3. Aktualisierte Werte: die verschiedenen Spalten, die wir aktualisieren möchten, werden als Anfragebody gesendet

Ausgabe-Extraktor

1. Array von Objekten
2. Jedes Objekt hatte RecordId und andere Felder der Tabelle

Video