API de Enterprise de Airtable

Airtable’s Enterprise API documentation can be accessed when logged into an Airtable account connected to an Enterprise Scale workspace. El siguiente artículo es una breve descripción de la API de Airtable, ya que se refiere específicamente a nuestros clientes de Enterprise.

Descripción general

Si tú o tu equipo tienen experiencia en desarrollo, el uso de nuestra API puede ayudarles a realizar ciertas acciones programáticas o masivas que, de otro modo, requerirían un trabajo tedioso, repetitivo o manual. Para acceder y usar la API de Enterprise, necesitarás lo siguiente:

• una cuenta de Airtable
• un espacio de trabajo o varios espacios de trabajo en Enterprise Scale

La API de Enterprise de Airtable usa la autenticación por clave (token) como la API web de Airtable. Todas las solicitudes deben enviar la clave de API en el encabezado de autorización. Al iniciar sesión en una cuenta de Enterprise, encontrarás la documentación relacionada con Enterprise marcada con un ícono de "Enterprise" púrpura:

Además, todas las solicitudes a estos terminales se deben realizar desde el lado del servidor. No se permiten las solicitudes del lado del cliente porque expondrían la clave de API del usuario.

Uso de la API de Enterprise de Airtable

El panel de administración de Airtable ofrece una interfaz para revisar los usuarios, las bases y los espacios de trabajo, así como para establecer la configuración de seguridad en toda la empresa. La API de Enterprise permite a los equipos gestionar las cuentas por programación fuera de la IU del panel de administración mediante acciones como gestionar usuarios, actualizar los permisos de acceso y gestionar las bases, tablas y vistas.

En ocasiones, es posible que algunos equipos deseen añadir sus propios metadatos a la información extraída por una solicitud de API, como información sobre departamentos, gestores o unidades de facturación. Esto les permite organizar sus recursos empresariales de manera más eficaz y realizar acciones cuando sea necesario.

La extensión de scripts y la acción de ejecutar automatización de script de Airtable les permite a los desarrolladores escribir un código de JavaScript incrustrado dentro de su aplicación personalizada. Al usarlas junto con la API de Enterprise, los desarrolladores pueden llevar a cabo una serie de funciones programáticas. En la siguiente sección, abordamos algunos casos de uso de ejemplo.

Casos de uso de ejemplo

Los siguientes terminales de API representan solo algunas de las maneras en que se puede usar nuestra API desde una perspectiva administrativa o de TI. 

Seguridad y gestión de usuarios

• Obtener información de usuario: obtener toda la información relacionada con un solo usuario.
• Desvincular a un usuario de todos los espacios de trabajos, bases e interfaces de la empresa.
• Gestionar un solo usuario o múltiples usuarios (en lote): actualizar el correo electrónico o activar/desactivar usuarios para fines de incorporación o salida de empleados.
• Borrar (revocar) o volver a generar las claves de API para un usuario específico.
• Crear o recuperar registros de auditoría: solicitar y recuperar registros de auditoría de las acciones realizadas en los espacios de trabajos y las bases de la empresa.
• Gestionar enlaces para compartir: este terminal permite a los admins gestionar los enlaces para compartir una base en toda la organización.

Gestión de bases y espacios de trabajo

• Crear bases, tablas y campos: en lugar de duplicar una base desde la IU, usa estos métodos de la API para crear bases, tablas y campos de Airtable mediante programación. Ten en cuenta que algunos tipos de campo avanzados, como fórmulas, no se pueden crear mediante API.
• Crea listas y borra vistas mediante programación.
• Gestión de colaboradores: añadir un solo usuario a una base o un espacio de trabajo. También puedes actualizar los permisos de usuario en una base o un espacio de trabajo.