Connettore Airtable

Connettore Airtable

Introduzione

L'integrazione Tulip-Airtable fornisce un modo semplice per integrare Tulip con i dati esistenti in Airtable. L'API segue strettamente la semantica REST, utilizza JSON per codificare gli oggetti e si basa su codici HTTP standard per segnalare i risultati delle operazioni. L'obiettivo di questo connettore è integrare Airtable con Tulip utilizzando i connettori HTTP e fornire ai nostri clienti un connettore Airtable pronto all'uso che può essere importato nella loro istanza.

Scopo

Verranno evidenziate diverse funzioni di connettore HTTP che possono essere costruite effettuando chiamate HTTP agli endpoint API di Airtable per interagire con le tabelle Airtable all'interno di uno spazio di lavoro per provare varie azioni di lettura e scrittura sulle tabelle che potrebbero essere sfruttate per vari casi d'uso. Esploreremo l'utilizzo di OAuth Bearer Token e sfrutteremo i vantaggi di

Documentazione API

Documentazione API di Airtable

Pre-requisiti

1. Creare un account su Airtable
2. Creare un nuovo spazio di lavoro e generare il token Bearer da usare come parte delle intestazioni della connessione.

Dettagli della connessione a Tulip

Le seguenti informazioni devono essere configurate sui connettori di Tulip.

1. In esecuzione su: Host del connettore cloud
2. Host :api.airtable.com
3. Porta:443
4. TLS:Sì
5. OAuth 2 (Bearer Token): L'autenticazione sarà trasmessa a tutte le funzioni del connettore.

Funzioni del connettore

Airtable Crea record

Scopo

Questa funzione del connettore crea un singolo o un elenco di record in Airtable.

Il corpo della richiesta deve includere un array di massimo 10 oggetti record. Ciascuno di questi oggetti deve avere una chiave, fields, che contiene tutti i valori del record per nome di campo. È possibile includere tutti, alcuni o nessuno dei valori dei campi.

Punto finale

Chiamata HTTP POST all'endpoint https://api.airtable.com/v0/base_id/TableName.

Input richiesti

I parametri da passare sono i seguenti

1. NomeTabella (URL)
2. Un array di oggetti passati come corpo della richiesta per la creazione di più record

Estrattore di output

1. Array di oggetti
2. Ogni oggetto ha RecordId e altri campi della tabella

Airtable Eliminare un record

Scopo

Questa funzione connettore cancella i dati da Airtable con il record_id fornito. I dati saranno eliminati dalla tabella in modo permanente.

Punto finale

Chiamata HTTP DELETE al punto finale -https://api.airtable.com/v0/base_id/TableName

Input richiesti

I parametri dell'URL da passare sono i seguenti

1. Nome della tabella
2. Id record

Airtable Ottieni record

Scopo

Questa funzione del connettore ottiene un singolo record da Airtable con l'Id del record fornito. Con questo connettore, possiamo ottenere i dati da modificare o utilizzare come input per un altro connettore.

Punto finale

Chiamata HTTP GET all'endpoint -https://api.airtable.com/v0/base_id/TableName

Input richiesti

I parametri dell'URL da passare sono i seguenti

1. Nome tabella
2. Id record

Estrattore di output

1. Array di oggetti
2. Ogni oggetto contiene RecordId e altri campi della tabella

Elenco di record della tabella

Scopo

Questa funzione del connettore ottiene un elenco di record da Airtable; il numero di record è definito dal parametro max records della query. Con questo connettore, si possono ottenere i dati da modificare o utilizzare come input per un altro connettore.

Punto finale

Chiamata HTTP GET all'endpoint -https://api.airtable.com/v0/base_id/TableName

Input richiesti

I parametri da passare sono i seguenti

1. Nome della tabella (URL)
2. MaxRecords: Numero che specifica il numero di record da recuperare (parametro della query).

Estrattore di output

1. Array di oggetti
2. Ogni oggetto ha RecordId e altri campi della tabella.

Record di aggiornamento di Airtable

Scopo

Questa funzione connettore aggiorna un record in Airtable.

Una richiesta PATCH aggiornerà solo i campi specificati dall'utente, lasciando il resto com'era. Il connettore accetta il nome della tabella, l'ID del record e l'elenco dei valori da aggiornare nella tabella.

Punto finale

Chiamata HTTP Patch all'endpoint -https://api.airtable.com/v0/base_id/TableName

Input richiesti

I parametri da passare sono i seguenti

1. Nome tabella (URL)
2. ID record (URL)
3. Valori aggiornati: le diverse colonne che si desidera aggiornare inviate come corpo della richiesta.

Estrattore di output

1. Array di oggetti
2. Ogni oggetto contiene l'ID del record e altri campi della tabella.

Video