Conector de mesa de ar

Conector de mesa de ar

Introdução

A integração Tulip-Airtable oferece uma maneira fácil de integrar o Tulip com os dados existentes no Airtable. A API segue de perto a semântica REST, usa JSON para codificar objetos e se baseia em códigos HTTP padrão para sinalizar os resultados da operação. O objetivo desse conector é integrar o Airtable com o Tulip usando conectores HTTP e fornecer aos nossos clientes um conector Airtable pronto para uso que possa ser importado para sua instância.

Objetivo

Vamos destacar diferentes funções do conector HTTP que podem ser criadas por meio de chamadas HTTP para pontos de extremidade da API do Airtable para interagir com o Airtables em um espaço de trabalho e experimentar várias ações de leitura e gravação nas tabelas que podem ser aproveitadas para vários casos de uso. Exploraremos o uso do token de portador OAuth e aproveitaremos

Documento da API

Documentação da API do Airtable

Pré-requisitos

1. Criar uma conta no Airtable
2. Criar um novo espaço de trabalho e gerar o token do portador para ser usado como parte dos cabeçalhos de conexão.

Detalhes da conexão do Tulip

As informações a seguir precisariam ser configuradas nos conectores do Tulip.

1. Em execução: host do conector de nuvem
2. Host: api.airtable.com
3. Porta:443
4. TLS:Sim
5. OAuth 2 (token de portador): A autenticação será levada adiante para todas as funções do conector.

Funções do conector

Airtable Create Record

Objetivo

Essa função de conector cria um único registro ou uma lista de registros no Airtable.

O corpo da solicitação deve incluir uma matriz de até 10 objetos de registro. Cada um desses objetos deve ter uma chave, campos, que contém todos os valores do seu registro por nome de campo. Você pode incluir todos, alguns ou nenhum dos valores de campo.

Ponto de extremidade

Chamada HTTP POST para o ponto de extremidade https://api.airtable.com/v0/base_id/TableName

Entrada obrigatória

A seguir, os parâmetros que devem ser passados

1. TableName (URL)
2. Uma matriz de objetos passada como corpo da solicitação para criar vários registros

Extrator de saída

1. Matriz de objetos
2. Cada objeto tem RecordId e outros campos da tabela

Airtable Excluir registro

Objetivo

Essa função de conector excluirá os dados do Airtable com o record_id fornecido. Os dados serão excluídos permanentemente da tabela

Ponto final

Chamada HTTP DELETE para o ponto de extremidade -https://api.airtable.com/v0/base_id/TableName

Entrada obrigatória

A seguir estão os parâmetros de URL que devem ser passados

1. Nome da tabela
2. Id do registro

Tabela aérea Obter registro

Objetivo

Essa função de conector obtém um único registro do Airtable com o Record Id fornecido. Com esse conector, podemos obter os dados para modificar ou usar como entradas para outro conector

Ponto final

Chamada HTTP GET para o ponto de extremidade -https://api.airtable.com/v0/base_id/TableName

Entrada obrigatória

A seguir estão os parâmetros de URL que devem ser passados

1. TableName
2. Id do registro

Extrator de saída

1. Matriz de objetos
2. Cada objeto tinha o RecordId e outros campos da tabela

Lista de registros da Airtable

Objetivo

Essa função de conector obtém uma lista de registros do Airtable; o número de registros é definido pelo parâmetro de consulta max records. Com esse conector, podemos obter os dados para modificar ou usar como entradas para outro conector

Ponto de extremidade

Chamada HTTP GET para o ponto de extremidade -https://api.airtable.com/v0/base_id/TableName

Entrada obrigatória

A seguir estão os parâmetros que devem ser passados

1. Nome da tabela (URL)
2. MaxRecords: Número que especifica o número de registros a serem buscados (parâmetro de consulta)

Extrator de saída

1. Matriz de objetos
2. Cada objeto tinha RecordId e outros campos da tabela

Registro de atualização da tabela aérea

Objetivo

Essa função de conector atualiza um registro no Airtable.

Uma solicitação PATCH atualizará apenas os campos que você especificar, deixando o restante como estava. O conector receberá o nome da tabela, o ID do registro e a lista de valores a serem atualizados na tabela.

Ponto de extremidade

Chamada HTTP Patch para o ponto de extremidade -https://api.airtable.com/v0/base_id/TableName

Entrada obrigatória

A seguir estão os parâmetros que devem ser passados

1. TableName (URL)
2. Id do registro (URL)
3. Valores atualizados: as diferentes colunas que gostaríamos de atualizar enviadas como o corpo da solicitação

Extrator de saída

1. Matriz de objetos
2. Cada objeto tinha o RecordId e outros campos da tabela

Vídeo