Saltar al contenido principal

Integraciones y API REST

NocoDB genera automaticamente una API REST para cada tabla que creas. Esto te permite conectar NocoDB con cualquier otra aplicacion.

Obtener tu API Token​

  1. Haz clic en tu avatar (esquina superior derecha)
  2. Ve a Account Settings
  3. Selecciona API Tokens
  4. Haz clic en Add New Token
  5. Dale un nombre descriptivo y copia el token
Importante

Guarda el token en un lugar seguro. No lo compartas y no lo incluyas en codigo publico.

Usar la API​

Autenticacion​

Incluye el token en el header de cada request:

curl -X GET "https://tu-nocodb.deployalo.com/api/v1/db/data/noco/miproyecto/mitabla" \
  -H "xc-token: TU_API_TOKEN"

Endpoints basicos​

MetodoEndpointDescripcion
GET/api/v1/db/data/noco/{proyecto}/{tabla}Listar registros
GET/api/v1/db/data/noco/{proyecto}/{tabla}/{id}Obtener un registro
POST/api/v1/db/data/noco/{proyecto}/{tabla}Crear registro
PATCH/api/v1/db/data/noco/{proyecto}/{tabla}/{id}Actualizar registro
DELETE/api/v1/db/data/noco/{proyecto}/{tabla}/{id}Eliminar registro

Ejemplos​

Listar todos los registros:

curl "https://tu-nocodb.deployalo.com/api/v1/db/data/noco/ventas/clientes" \
  -H "xc-token: TU_TOKEN"

Crear un registro:

curl -X POST "https://tu-nocodb.deployalo.com/api/v1/db/data/noco/ventas/clientes" \
  -H "xc-token: TU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"nombre": "Juan", "email": "[email protected]"}'

Filtrar registros:

curl "https://tu-nocodb.deployalo.com/api/v1/db/data/noco/ventas/clientes?where=(status,eq,activo)" \
  -H "xc-token: TU_TOKEN"

Integracion con n8n​

NocoDB se integra perfectamente con n8n para automatizaciones.

Leer datos de NocoDB​

  1. En n8n, agrega el nodo HTTP Request
  2. Configura:
    • Method: GET
    • URL: https://tu-nocodb.deployalo.com/api/v1/db/data/noco/proyecto/tabla
    • Header: xc-token = tu token

Escribir datos en NocoDB​

  1. Usa el nodo HTTP Request con Method: POST
  2. En Body, selecciona JSON y pasa tus datos

Webhook de NocoDB hacia n8n​

  1. En NocoDB, ve a Automations en tu tabla
  2. Crea una nueva automatizacion
  3. Como trigger, selecciona "After Record Create" (o el evento que necesites)
  4. Como accion, selecciona Webhook
  5. Pega la URL del webhook de n8n

Integracion con Zapier/Make​

Puedes usar la API REST de NocoDB con cualquier plataforma de automatizacion:

  1. Busca el conector "Webhook" o "HTTP"
  2. Configura los endpoints de la API
  3. Usa tu API token en los headers

Integracion con aplicaciones externas​

JavaScript/Node.js​

const API_URL = 'https://tu-nocodb.deployalo.com/api/v1/db/data/noco';
const TOKEN = 'tu_token';

// Obtener registros
const response = await fetch(`${API_URL}/proyecto/tabla`, {
  headers: { 'xc-token': TOKEN }
});
const data = await response.json();

Python​

import requests

API_URL = 'https://tu-nocodb.deployalo.com/api/v1/db/data/noco'
TOKEN = 'tu_token'

headers = {'xc-token': TOKEN}
response = requests.get(f'{API_URL}/proyecto/tabla', headers=headers)
data = response.json()

Webhooks​

NocoDB puede enviar notificaciones cuando ocurren eventos:

  1. Ve a tu tabla
  2. Haz clic en Automations
  3. Crea una nueva automatizacion
  4. Selecciona el trigger (crear, actualizar, eliminar)
  5. Configura la accion webhook con la URL destino

Limites de la API​

  • Rate limit: 60 requests por minuto por defecto
  • Tamano de respuesta: Maximo 1000 registros por pagina
  • Timeout: 30 segundos por request

Para paginacion, usa los parametros limit y offset:

?limit=100&offset=200