Saltar al contenido principal

Conectar APIs REST en ToolJet

ToolJet puede conectarse a cualquier API REST para leer y escribir datos.

Agregar API como datasource​

  1. Ve a Data sources
  2. Clic en + Add datasource
  3. Selecciona REST API
  4. Configura:
    • Name: Nombre descriptivo
    • Base URL: URL base de la API
    • Headers: Headers por defecto (Authorization, etc.)

Autenticación​

Bearer Token​

Authorization: Bearer tu-token-aqui

API Key​

X-API-Key: tu-api-key

Basic Auth​

Activa "Basic auth" e ingresa usuario/contraseña.

Crear queries a la API​

GET - Obtener datos​

  1. Nueva query → Selecciona tu API
  2. Method: GET
  3. Endpoint: /users
  4. Run para probar

POST - Enviar datos​

  1. Method: POST
  2. Endpoint: /users
  3. Body:
{
  "name": "{{components.nameInput.value}}",
  "email": "{{components.emailInput.value}}"
}

Parámetros dinámicos​

Usa {{}} para valores dinámicos:

  • {{components.searchInput.value}} - Valor de un input
  • {{queries.query1.data[0].id}} - Dato de otra query
  • {{globals.currentUser.email}} - Usuario actual

Ejemplo: Integrar con Stripe​

1. Configurar datasource​

  • Base URL: https://api.stripe.com/v1
  • Header: Authorization: Bearer sk_live_xxx

2. Query: Listar clientes​

  • GET /customers?limit=100

3. Query: Crear cliente​

  • POST /customers
  • Body: email={{components.emailInput.value}}

Manejo de errores​

// En transformación de query
if (data.error) {
  return { success: false, message: data.error.message }
}
return { success: true, data: data }