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 Configuracion > API, genera tu clave con los permisos necesarios para tu integracion.
Prueba en Sandbox
Usa el entorno de pruebas para desarrollar y probar sin afectar datos reales.
Integra y despliega
Conecta tu aplicacion con el entorno de produccion 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 sincronizacion automatica con canales.
GET /inventoryPUT /inventory/:skuPOST /inventory/adjust+2 endpoints masCustomers API
Gestiona tu base de clientes. Historial de compras, segmentacion y datos de contacto unificados.
GET /customersPOST /customersGET /customers/:id+2 endpoints masChannels API
Administra conexiones con marketplaces y plataformas. Estado de sincronizacion y configuracion 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 masAutenticacion Robusta
Fenicia soporta multiples metodos de autenticacion 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 autorizacion seguro y estandar.
JWT Tokens
Tokens de corta duracion para sesiones de usuario con renovacion automatica.
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 integracion sin riesgo. El sandbox incluye datos de ejemplo y simula todos los flujos de la API de produccion.
- 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 sincronizacion
- -Mejora en respuesta de orders con paginacion optimizada
- -Nuevo filtro por canal de venta
- -API de Customers con historial de compras
- -Webhooks para eventos de clientes
Explora la API
Documentacion 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 Tecnico
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