REST API v1

API de Integración

Conecta tu sitio web, tienda online o cualquier sistema para sincronizar productos, servicios, páginas y precios automáticamente con el asistente IA.

Quick Start — 3 pasos

1

Obtén tu API Key

Ve a tu panel → Integración API → Crear API Key. Guárdala, solo se muestra una vez.

2

Envía tus datos

Usa POST con tu API key para sincronizar productos, páginas o cualquier dato.

3

El IA ya lo sabe

Los datos se indexan automáticamente. Tu asistente responde con la información actualizada.

Autenticación

Todas las peticiones requieren una API Key válida. Puedes enviarla de dos formas:

# Opción 1: Header Authorization
curl -H "Authorization: Bearer wba_tu_api_key_aqui" \
     https://tu-dominio.com/api/integration/v1/status

# Opción 2: Header X-Api-Key
curl -H "X-Api-Key: wba_tu_api_key_aqui" \
     https://tu-dominio.com/api/integration/v1/status

⚠️ Importante: Las API keys empiezan con wba_ y solo se muestran una vez al crearlas. Guárdalas en un lugar seguro.

URL Base

https://tu-dominio.com/api/integration/v1

Endpoints

Webhooks Salientes

Configura webhooks en tu panel para recibir notificaciones cuando se sincronicen datos. Cada entrega incluye una firma HMAC-SHA256 para verificar autenticidad.

// Header enviado con cada webhook:
X-Webhook-Signature: hmac_sha256(body, secret)
X-Webhook-Event: products.synced

// Payload del webhook:
{
  "event": "products.synced",
  "data": { "count": 5, "items": [...] },
  "timestamp": "2026-03-07T16:00:00.000Z"
}

// Eventos disponibles:
// products.synced, services.synced, pages.synced,
// faq.synced, bulk.synced, crawl.completed, product.deleted,
// order.created, order.updated, stock.updated, cart.abandoned

Verificar firma en tu servidor

// PHP
$body = file_get_contents('php://input');
$signature = hash_hmac('sha256', $body, $webhook_secret);
$valid = hash_equals($signature, $_SERVER['HTTP_X_WEBHOOK_SIGNATURE']);

// Node.js
const crypto = require('crypto');
const sig = crypto.createHmac('sha256', secret).update(body).digest('hex');
const valid = sig === req.headers['x-webhook-signature'];

// Python
import hmac, hashlib
sig = hmac.new(secret.encode(), body.encode(), hashlib.sha256).hexdigest()
valid = hmac.compare_digest(sig, request.headers['X-Webhook-Signature'])

Códigos de Error

CódigoErrorDescripción
401MISSING_KEYNo se envió API key en el header
401INVALID_KEYLa API key no tiene formato válido (debe empezar con wba_)
401KEY_NOT_FOUNDLa API key no existe en el sistema
403KEY_DISABLEDLa API key fue desactivada
403KEY_EXPIREDLa API key expiró
400Datos de entrada inválidos o faltantes
404Recurso no encontrado
500Error interno del servidor

¿Listo para integrar?

Crea tu cuenta, genera tu API key y empieza a sincronizar datos en minutos.