Разъем для подключения к воздушному столу

Коннектор Airtable

Введение

Интеграция Tulip-Airtable обеспечивает простой способ интеграции Tulip с существующими данными в Airtable. API полностью соответствует семантике REST, использует JSON для кодирования объектов и опирается на стандартные HTTP-коды для сигнализации о результатах операций. Цель данного коннектора - интегрировать Airtable с Tulip с помощью HTTP-коннекторов и предоставить нашим клиентам готовый коннектор Airtable, который можно импортировать в свой экземпляр.

Назначение

Мы рассмотрим различные функции HTTP-коннекторов, которые могут быть построены путем выполнения HTTP-вызовов к конечным точкам API Airtable для взаимодействия с таблицами Airtable в рабочем пространстве, чтобы опробовать различные действия чтения и записи в таблицы, которые могут быть использованы для различных сценариев использования. Мы рассмотрим использование OAuth Bearer Token и воспользуемся преимуществами

Документация по API

Документация по API Airtable

Предварительные требования

1. Создайте учетную запись на Airtable
2. Создайте новое рабочее пространство и сгенерируйте токен Bearer, который будет использоваться в заголовках соединения.

Детали подключения Tulip

На коннекторах Tulip необходимо настроить следующую информацию.

1. Running On: Cloud Connector Host
2. Хост :api.airtable.com
3. Порт:443
4. TLS:Да
5. OAuth 2(Bearer Token): Аутентификация будет передана всем функциям коннектора.

Функции коннектора

Airtable Create Record

Назначение

Эта функция коннектора создает в Airtable одну или список записей.

Тело запроса должно содержать массив до 10 объектов записей. Каждый из этих объектов должен иметь один ключ - fields, который содержит все значения записи по имени поля. Вы можете включить все, некоторые или ни одного значения поля.

Конечная точка

HTTP POST-вызов конечной точки https://api.airtable.com/v0/base_id/TableName.

Необходимые параметры

Ниже перечислены параметры, которые необходимо передать

1. TableName (URL)
2. Массив объектов, передаваемых в качестве тела запроса для создания нескольких записей

Выходной экстрактор

1. Массив объектов
2. Каждый объект содержит RecordId и другие поля таблицы

Airtable Delete Record

Назначение

Эта функция коннектора удалит данные из Airtable с указанным record_id. Данные будут удалены из таблицы безвозвратно

Конечная точка

HTTP DELETE вызов конечной точки -https://api.airtable.com/v0/base_id/TableName

Требуемый ввод

Ниже перечислены параметры URL, которые необходимо передать

1. Имя таблицы
2. Ид записи

Airtable Get Record

Назначение

Эта функция коннектора получает одну запись из Airtable с указанным идентификатором Record Id. С помощью этого коннектора мы можем получить данные для модификации или использования в качестве входных данных для другого коннектора.

Конечная точка

HTTP GET вызов конечной точки -https://api.airtable.com/v0/base_id/TableName

Требуемые входные данные

Ниже перечислены параметры URL, которые необходимо передать

1. TableName
2. Id записи

Выходной экстрактор

1. Массив объектов
2. Каждый объект содержит RecordId и другие поля таблицы

Список записей таблицы

Назначение

Данная функция коннектора получает список записей из Airtable, количество записей определяется параметром запроса max records. С помощью этого коннектора мы можем получить данные для модификации или использования в качестве входных данных для другого коннектора.

Конечная точка

HTTP GET вызов конечной точки -https://api.airtable.com/v0/base_id/TableName

Необходимые входные данные

Ниже перечислены параметры, которые необходимо передать

1. Имя таблицы (URL)
2. MaxRecords: Число, определяющее количество записей, которые необходимо найти (параметр запроса)

Выходной экстрактор

1. Массив объектов
2. Каждый объект содержал RecordId и другие поля таблицы

Airtable Update Record

Назначение

Эта функция коннектора обновляет запись в Airtable.

Запрос PATCH обновляет только указанные поля, оставляя остальные поля без изменений. Коннектор принимает имя таблицы, Record Id и список значений, которые необходимо обновить в таблице.

Конечная точка

HTTP Patch вызов конечной точки -https://api.airtable.com/v0/base_id/TableName

Требуемый ввод

Ниже перечислены параметры, которые необходимо передать

1. TableName (URL)
2. Record Id (URL)
3. Updated Values: различные колонки, которые мы хотим обновить, отправленные в качестве тела запроса.

Выходной экстрактор

1. Массив объектов
2. Каждый объект содержал RecordId и другие поля таблицы

Видео