Saltar al contenido principal

Usar Sheet Best desde Bubble

Sheet Best es una API REST estándar, por lo que una aplicación de Bubble puede acceder a ella mediante el complemento integrado API Connector, sin instalar un complemento personalizado. Los ejemplos muestran las solicitudes que configurarás como llamadas a la API.

Antes de empezar​

  • Una conexión de Sheet Best. Consulta la guía rápida.
  • Una aplicación de Bubble con el complemento API Connector instalado.
  • Una clave de API solo si tu conexión está protegida. Consulta autenticación con clave de API.

Configurar la API en Bubble​

En API Connector, añade una nueva API para Sheet Best. Necesitas estos dos datos:

  • URL base: https://api.sheetbest.com/sheets/<id>
  • Cabecera compartida (opcional): X-Api-Key: <your-key> si tu conexión está protegida

Todas las llamadas siguientes pueden reutilizar esta configuración.

Leer filas (GET)​

Configura una llamada con el método GET y la URL de tu conexión. La respuesta es un array JSON de objetos de fila cuyas claves son las cabeceras de las columnas. Inicializa la llamada para que Bubble detecte el esquema de la respuesta.

GET https://api.sheetbest.com/sheets/<id>

Los valores se devuelven como cadenas de texto de forma predeterminada. Añade ?_raw=1 si necesitas tipos JSON nativos; consulta formatos.

Escribir filas (POST)​

Configura una llamada con el método POST, la URL de tu conexión y un cuerpo JSON. Sheet Best acepta un objeto o un array de objetos (una fila por elemento). Marca cada campo del cuerpo como parámetro para vincularlo a las entradas de Bubble al ejecutar la acción.

{
  "Name": "<Name>",
  "Email": "<Email>"
}

Asegúrate de que el tipo de cuerpo sea JSON. Los nombres de los campos deben coincidir con las cabeceras de las columnas de tu hoja.

Autenticarse​

Para una conexión protegida, añade una cabecera X-Api-Key, compartida por toda la API o específica de cada llamada:

X-Api-Key: <your-key>

Consulta autenticación con clave de API.

Actualizar y eliminar filas​

El mismo patrón se aplica a otros métodos:

Para seleccionar una fila concreta, incluye una coincidencia de columna en la URL, por ejemplo PATCH /sheets/<id>/Email/[email protected].

Próximos pasos​