Conector Airtable

Conector Airtable

Introducción

La integración Tulip-Airtable proporciona una manera fácil de integrar Tulip con los datos existentes en Airtable. La API sigue de cerca la semántica REST, utiliza JSON para codificar objetos, y se basa en códigos HTTP estándar para señalar los resultados de la operación. El objetivo de este conector es integrar Airtable con Tulip utilizando conectores HTTP y proporcionar a nuestros clientes un conector Airtable listo para usar que puede ser importado en su instancia.

Propósito

Vamos a destacar diferentes funciones de conectores HTTP que se pueden construir haciendo llamadas HTTP a los puntos finales de la API de Airtable para interactuar con las Airtables dentro de un espacio de trabajo para probar varias acciones de lectura y escritura en las tablas que podrían ser aprovechadas para diversos casos de uso. Exploraremos el uso de OAuth Bearer Token y tomaremos ventaja del

Documentación API

Documentación API Airtable

Requisitos previos

1. Crear una cuenta en Airtable
2. Crear un nuevo espacio de trabajo, y Generar Bearer token para ser utilizado como parte de los encabezados de conexión.

Detalles de la conexión Tulip

La siguiente información necesitaría ser configurada en los conectores de Tulip.

1. Ejecutando en: Cloud Connector Host
2. Host :api.airtable.com
3. Puerto:443
4. TLS:Sí
5. OAuth 2(Token Portador): La autenticación se llevará a cabo a todas las funciones del conector.

Funciones de Conector

Airtable Crear registro

Propósito

Esta función de conector crea un único registro o una lista de registros dentro de Airtable.

El cuerpo de la solicitud debe incluir una matriz de hasta 10 objetos de registro. Cada uno de estos objetos debe tener una clave, fields, que contiene todos los valores del registro por nombre de campo. Puede incluir todos, algunos o ninguno de los valores de campo.

Punto final

Llamada HTTP POST al punto final https://api.airtable.com/v0/base_id/TableName

Entrada obligatoria

Los siguientes son los parámetros que deben pasarse

1. TableName (URL)
2. Un array de objetos pasados como cuerpo de la petición para crear múltiples registros

Extractor de salida

1. Matriz de objetos
2. Cada objeto tiene RecordId, y otros campos de la tabla

Airtable Eliminar registro

Propósito

Esta función del conector borrará los datos de Airtable con el record_id proporcionado. Los datos se eliminarán de la tabla de forma permanente

Punto final

Llamada HTTP DELETE al endpoint -https://api.airtable.com/v0/base_id/TableName

Entrada Requerida

Los siguientes son los parámetros URL que deben ser pasados

1. Nombre de la tabla
2. Id de registro

Airtable Obtener registro

Propósito

Esta función del conector obtiene un único registro de Airtable con el Id. de registro proporcionado. Con este conector, podemos obtener los datos para modificarlos o utilizarlos como entradas para otro conector.

Punto final

Llamada HTTP GET al punto final -https://api.airtable.com/v0/base_id/TableName

Entrada requerida

Los siguientes son los parámetros de URL que se deben pasar

1. NombreTabla
2. Id. de registro

Salida Extractor

1. Matriz de objetos
2. Cada objeto tiene RecordId y otros campos de la tabla

Lista de registros de Airtable

Propósito

Esta función del conector obtiene una lista de registros de Airtable, el número de registros está definido por el parámetro de consulta max records. Con este conector, podemos obtener los datos para modificarlos o utilizarlos como entrada para otro conector.

Punto final

Llamada HTTP GET al endpoint -https://api.airtable.com/v0/base_id/TableName

Entrada requerida

Los parámetros que deben pasarse son los siguientes

1. Nombre de la tabla (URL)
2. MaxRecords: Número que especifica el número de registros que se deben obtener (parámetro de consulta)

Salida Extractor

1. Matriz de objetos
2. Cada objeto tiene RecordId, y otros campos de la tabla

Airtable Actualizar Registro

Propósito

Esta función del conector actualiza un registro dentro de Airtable.

Una petición PATCH sólo actualizará los campos que usted especifique, dejando el resto como estaban. El Conector tomará el Nombre de la tabla, el Id de Registro y la lista de valores a actualizar en la tabla.

Punto final

Llamada HTTP Patch al endpoint -https://api.airtable.com/v0/base_id/TableName

Entrada requerida

Los siguientes son los parámetros que deben pasarse

1. Nombre de la tabla (URL)
2. Record Id (URL)
3. Valores actualizados: las distintas columnas que deseamos actualizar enviadas como cuerpo de la solicitud

Extractor de salida

1. Matriz de objetos
2. Cada objeto contiene el RecordId y otros campos de la tabla

Vídeo