Operaciones internas del comercio
La API Admin es cómo operas Fire spark desde el lado del comercio. Úsala para construir herramientas internas, sincronizar datos de clientes en bulk, consultar pedidos de todos los canales y migrar registros desde sistemas legacy — sin tocar flujos customer-facing ni integraciones POS directamente. Si la API Storefront impulsa los canales que usan tus clientes (app, web, kiosco), y la API de integraciones conecta tu POS y RMS con esos canales, la API Admin es la capa de back-office y operaciones: dashboards, puentes con CRM, pipelines de datos y scripts de onboarding.¿Nuevo en Fire spark?
Conecta un comercio en el panel antes de llamar a la API Admin.
Qué puedes construir
| Caso de uso | Consumidor típico |
|---|---|
| Dashboard de operaciones | Equipo interno monitoreando pedidos cross-channel |
| Sync con CRM | Push y pull de perfiles de cliente en bulk |
| Reporting y BI | Exportar historial de pedidos para analítica |
| Migración de datos | Importar clientes y pedidos desde una plataforma legacy |
| Scripts de automatización | Jobs programados que reconcilian o actualizan datos del comercio |
Cómo funciona
Autentica tu servidor
Tu backend obtiene un access token con OAuth 2.0 client credentials. Guarda
tu
client_id y client_secret de forma segura — nunca los expongas en
código del lado del cliente.Opera sobre datos del comercio
Llama endpoints para listar y gestionar clientes en bulk, consultar pedidos
de todos los canales o ejecutar jobs de migración durante el onboarding.
Áreas de la API
Autenticación
OAuth 2.0 client credentials protege el acceso a cada endpoint de la API Admin. Autentica desde tu servidor antes de hacer llamadas bulk o de migración.Autorizar
Obtén un access token con client credentials.
Clientes (bulk)
Crea, lee, actualiza y elimina registros de cliente en bulk. Usa estos endpoints para sincronizar un CRM, importar una lista de contactos o reconciliar datos de clientes entre sistemas.| Endpoint | Propósito |
|---|---|
GET /customers/bulk | Listar o exportar clientes |
POST /customers/bulk | Crear clientes en lote |
PATCH /customers/bulk | Actualizar clientes en lote |
DELETE /customers/bulk | Eliminar clientes en lote |
Pedidos
Consulta pedidos de todos los canales y tiendas de un comercio. Úsalo para dashboards operativos, herramientas de soporte o pipelines de reporting.Listar pedidos
Obtener pedidos de todos los canales.
Migración
Importa clientes y pedidos históricos desde una plataforma legacy durante el onboarding. Los endpoints de migración soportan imports en lote con una vía de revert si algo sale mal.Migrar clientes
Importar clientes desde un sistema legacy
Migrar pedidos
Importar pedidos históricos
Revertir migración
Revertir un lote de migración
API Admin vs API Storefront vs API de integraciones
| API Admin | API Storefront | API de integraciones | |
|---|---|---|---|
| Quién la llama | Backend del comercio, herramientas internas | App, web, kiosco customer-facing | Partners de POS/RMS |
| Autenticación | Client credentials (servidor) | Exchange de ID token OIDC (cliente) | Client credentials (servidor) |
| Clientes | Lectura/escritura bulk, migración | Perfil y consentimiento por cliente | No aplica |
| Pedidos | Consulta cross-channel | Crear y gestionar por cliente | Recibir vía webhook, inyectar al POS |
| Objetivo principal | Operar y hacer onboarding de datos | Construir canales de venta propios | Sincronizar menús e inyectar pedidos |
URL base
Próximos pasos
Autorizar
Obtener un access token
Guía para desarrolladores
Configurar tu integración de servidor
Clientes bulk
Leer y gestionar clientes en bulk
Límites de tasa
Revisar rate limits y cuotas