- Wydrukować
Złącze Airtable
Wprowadzenie
Integracja Tulip-Airtable zapewnia łatwy sposób integracji Tulip z istniejącymi danymi w Airtable. Interfejs API jest ściśle zgodny z semantyką REST, wykorzystuje JSON do kodowania obiektów i opiera się na standardowych kodach HTTP do sygnalizowania wyników operacji. Celem tego konektora jest integracja Airtable z Tulip przy użyciu konektorów HTTP i zapewnienie naszym klientom gotowego konektora Airtable, który można zaimportować do ich instancji.
Cel
Zamierzamy podkreślić różne funkcje konektorów HTTP, które można zbudować, wykonując wywołania HTTP do punktów końcowych API Airtable w celu interakcji z Airtables w obszarze roboczym, aby wypróbować różne akcje odczytu i zapisu na tabelach, które można wykorzystać w różnych przypadkach użycia. Przeanalizujemy wykorzystanie tokenu bearer OAuth i skorzystamy z
Dokumentacja API
Wymagania wstępne
- Utwórz konto na Airtable
- Utwórz nowy obszar roboczy i wygeneruj token okaziciela, który będzie używany jako część nagłówków połączenia.
Szczegóły połączenia Tulip
Poniższe informacje muszą zostać skonfigurowane w konektorach Tulip.
- Running On: Cloud Connector Host
- Host :api.airtable.com
- Port:443
- TLS:Tak
- OAuth 2(Bearer Token): Uwierzytelnianie będzie przekazywane do wszystkich funkcji Connector.
Funkcje konektora
Airtable Create Record
Cel
Ta funkcja konektora tworzy pojedynczy rekord lub listę rekordów w Airtable.
Treść żądania powinna zawierać tablicę do 10 obiektów rekordów. Każdy z tych obiektów powinien mieć jeden klucz, fields, który zawiera wszystkie wartości rekordu według nazwy pola. Możesz dołączyć wszystkie, niektóre lub żadne wartości pól.
Punkt końcowy
Wywołanie HTTP POST do punktu końcowego https://api.airtable.com/v0/base_id/TableName
Wymagane dane wejściowe
Poniżej znajdują się parametry, które należy przekazać
- TableName (URL)
- Tablica obiektów przekazana jako treść żądania w celu utworzenia wielu rekordów
Wyjście Extractor
- Tablica obiektów
- Każdy obiekt ma RecordId i inne pola tabeli
Airtable Usuń rekord
Cel
Ta funkcja konektora usunie dane z Airtable z podanym record_id. Dane zostaną trwale usunięte z tabeli
Punkt końcowy
Wywołanie HTTP DELETE do punktu końcowego -https://api.airtable.com/v0/base_id/TableName
Wymagane dane wejściowe
Poniżej znajdują się parametry URL, które należy przekazać
- Nazwa tabeli
- Id rekordu
Airtable Get Record
Cel
Ta funkcja konektora pobiera pojedynczy rekord z Airtable z podanym identyfikatorem rekordu. Dzięki temu konektorowi możemy uzyskać dane do modyfikacji lub wykorzystania jako dane wejściowe do innego konektora.
Punkt końcowy
Wywołanie HTTP GET do punktu końcowego -https://api.airtable.com/v0/base_id/TableName
Wymagane dane wejściowe
Poniżej znajdują się parametry URL, które należy przekazać
- TableName
- Id rekordu
Wyjście Extractor
- Tablica obiektów
- Każdy obiekt posiadał RecordId i inne pola tabeli
Lista rekordów tabeli Airtable
Cel
Ta funkcja konektora pobiera listę rekordów z Airtable, liczba rekordów jest określona przez parametr zapytania max records. Za pomocą tego konektora możemy uzyskać dane do modyfikacji lub wykorzystania jako dane wejściowe do innego konektora.
Punkt końcowy
Wywołanie HTTP GET do punktu końcowego -https://api.airtable.com/v0/base_id/TableName
Wymagane dane wejściowe
Poniżej znajdują się parametry, które należy przekazać
- Nazwa tabeli (URL)
- MaxRecords: Liczba określająca liczbę rekordów do pobrania (parametr zapytania)
Wyjście Extractor
- Tablica obiektów
- Każdy obiekt posiadał RecordId i inne pola tabeli
Airtable Update Record
Cel
Ta funkcja konektora aktualizuje rekord w Airtable.
Żądanie PATCH zaktualizuje tylko określone pola, pozostawiając resztę bez zmian. Konektor pobiera nazwę tabeli, identyfikator rekordu i listę wartości, które mają zostać zaktualizowane w tabeli.
Punkt końcowy
Wywołanie HTTP Patch do punktu końcowego -https://api.airtable.com/v0/base_id/TableName
Wymagane dane wejściowe
Poniżej znajdują się parametry, które należy przekazać
- TableName (URL)
- Record Id (URL)
- Updated Values: różne kolumny, które chcemy zaktualizować, wysyłane jako treść żądania.
Wyjście Extractor
- Tablica obiektów
- Każdy obiekt miał RecordId i inne pola tabeli