Construye integraciones
poderosas con Fenicia
API REST completa y bien documentada para conectar tu sistema con todo el ecosistema de e-commerce. SDKs oficiales, webhooks en tiempo real y sandbox para pruebas.
// Ejemplo: Obtener pedidos pendientes
const Fenicia = require('@fenicia/sdk');
const client = new Fenicia({
apiKey: process.env.FENICIA_API_KEY,
environment: 'production' // o 'sandbox' para pruebas
});
// Listar pedidos con filtros
const orders = await client.orders.list({
status: 'pending',
channel: 'mercadolibre',
limit: 50
});
console.log(`Pedidos encontrados: ${orders.total}`);
// Procesar cada pedido
for (const order of orders.data) {
console.log(`Pedido #${order.id} - ${order.customer.name}`);
// Marcar como aceptado
await client.orders.accept(order.id);
}Comienza en 4 Pasos
Desde cero hasta tu primera llamada a la API en menos de 10 minutos
Crea tu cuenta
Registrate en Fenicia y accede al panel de desarrollador para obtener tus credenciales.
Genera tu API Key
En Configuración > API, genera tu clave con los permisos necesarios para tu integración.
Prueba en Sandbox
Usa el entorno de pruebas para desarrollar y probar sin afectar datos reales.
Integra y despliega
Conecta tu aplicación con el entorno de producción y monitorea el rendimiento.
APIs Principales
Accede a toda la funcionalidad de Fenicia a traves de nuestras APIs REST bien estructuradas
Orders API
Gestiona pedidos de todos tus canales de venta. Crea, actualiza, cancela y consulta pedidos con filtros avanzados.
GET /ordersPOST /ordersGET /orders/:id+2 endpoints masProducts API
Administra tu catalogo de productos. Sincroniza con marketplaces, gestiona variantes y actualiza precios.
GET /productsPOST /productsPUT /products/:id+2 endpoints masInventory API
Controla stock en tiempo real. Ajustes, transferencias entre ubicaciones y sincronización automática con canales.
GET /inventoryPUT /inventory/:skuPOST /inventory/adjust+2 endpoints masCustomers API
Gestiona tu base de clientes. Historial de compras, segmentación y datos de contacto unificados.
GET /customersPOST /customersGET /customers/:id+2 endpoints masChannels API
Administra conexiones con marketplaces y plataformas. Estado de sincronización y configuración de canales.
GET /channelsGET /channels/:idPUT /channels/:id/config+2 endpoints masWebhooks
Recibe notificaciones en tiempo real de eventos importantes: nuevos pedidos, cambios de stock, actualizaciones.
POST /webhooksGET /webhooksDELETE /webhooks/:id+2 endpoints masAutenticación Robusta
Fenicia soporta múltiples métodos de autenticación para adaptarse a diferentes casos de uso, desde integraciones servidor-a-servidor hasta aplicaciones de usuario final.
API Keys
Ideal para integraciones servidor-a-servidor. Genera claves con permisos granulares desde tu panel.
OAuth 2.0
Para aplicaciones que actuan en nombre de usuarios. Flujo de autorización seguro y estandar.
JWT Tokens
Tokens de corta duración para sesiones de usuario con renovación automática.
curl -X GET "https://api.fenicia.io/v2/orders" \
-H "Authorization: Bearer fk_live_a1b2c3d4e5f6g7h8i9j0" \
-H "Content-Type: application/json"
# Respuesta
{
"data": [...],
"meta": {
"total": 150,
"page": 1,
"limit": 50
}
}// Configurar webhook para nuevos pedidos
const webhook = await client.webhooks.create({
url: 'https://tu-servidor.com/webhooks/fenicia',
events: ['order.created', 'order.updated', 'inventory.low'],
secret: 'tu-secreto-para-validar'
});
// En tu servidor, valida y procesa eventos
app.post('/webhooks/fenicia', (req, res) => {
const signature = req.headers['x-fenicia-signature'];
if (!client.webhooks.verify(req.body, signature)) {
return res.status(401).send('Invalid signature');
}
const event = req.body;
switch (event.type) {
case 'order.created':
processNewOrder(event.data);
break;
case 'inventory.low':
alertLowStock(event.data);
break;
}
res.status(200).send('OK');
});Webhooks en Tiempo Real
Recibe notificaciones instantaneas cuando ocurren eventos importantes en tu cuenta. Sin polling, sin retrasos.
Limites de Peticiones
Limites generosos que crecen con tu plan. Headers claros en cada respuesta para monitorear tu uso.
| Plan | Por hora | Burst |
|---|---|---|
| Starter | 1,000 | 100/min |
| Professional | 10,000 | 500/min |
| Enterprise | 100,000 | 2,000/min |
HTTP/1.1 200 OK
X-RateLimit-Limit: 10000
X-RateLimit-Remaining: 9847
X-RateLimit-Reset: 1703980800
X-RateLimit-Retry-After: 0
# Si excedes el limite
HTTP/1.1 429 Too Many Requests
Retry-After: 45
{
"error": {
"code": "rate_limit_exceeded",
"message": "Limite excedido. Reintenta en 45s"
}
}Sandbox para Desarrolladores
Desarrolla y prueba tu integración sin riesgo. El sandbox incluye datos de ejemplo y simula todos los flujos de la API de producción.
- Datos de prueba predefinidos (pedidos, productos, clientes)
- Webhooks de prueba para simular eventos
- Sin limites de peticiones
- Reset de datos con un clic
Credenciales de Sandbox
https://api-sandbox.fenicia.io/v2fk_test_sample1234567890abcd* Genera tus propias credenciales de sandbox en el panel de desarrollador
Changelog de la API
Mantente al dia con las ultimas mejoras y nuevas funcionalidades
- -Nuevo endpoint para bulk operations en inventario
- -Soporte para webhooks de sincronización
- -Mejora en respuesta de orders con paginación optimizada
- -Nuevo filtro por canal de venta
- -API de Customers con historial de compras
- -Webhooks para eventos de clientes
Explora la API
Documentación interactiva donde puedes probar endpoints directamente desde tu navegador
/v2/ordersParametros de consulta
statusstringchannelstringfrom_dateISO 8601limitinteger (1-100)Respuesta ejemplo
{
"data": [
{
"id": "ord_abc123",
"status": "pending",
"channel": "mercadolibre",
"total": 1299.00,
"customer": {...}
}
],
"meta": {
"total": 42,
"page": 1
}
}Soporte para Desarrolladores
Estamos aqui para ayudarte a construir integraciones exitosas
Soporte Técnico
Contacta a nuestro equipo de integraciones para ayuda personalizada
developers@fenicia.io¿Listo para integrar con Fenicia?
Crea tu cuenta y obtén acceso inmediato a la API y al sandbox de desarrollo