MENU
    Разъем для подключения к воздушному столу
    • 03 Nov 2023
    • 2 Минуты для чтения
    • Авторы

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


    Вводный текст

    Коннектор 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 и другие поля таблицы

    Видео


    Была ли эта статья полезной?