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
La API Admin es solo servidor a servidor. No es para apps mobile, sitios web o kioscos donde inician sesión clientes finales.
Cómo funciona
1
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.2
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.
3
Los cambios se propagan en Fire spark
Actualizaciones de clientes y registros migrados entran a la misma capa
omnicanal que alimenta tus APIs Storefront e Integrations. Un cliente creado
vía API Admin está disponible en cada canal conectado.
Á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.Token
Obtén un access token con client credentials.
Tiendas
Crea ubicaciones del comercio usadas por menús, fulfillment y pedidos.Crear tienda
Crear una tienda para el comercio autenticado.
Actualizar tienda
Actualiza una tienda por id externo.
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.Pedidos
Consulta pedidos de todos los canales y tiendas de un comercio, o cancela un pedido antes del fulfillment. Úsalo para dashboards operativos, herramientas de soporte o pipelines de reporting.Listar pedidos
Obtener pedidos de todos los canales.
Cancelar pedido
Anula un pedido sin pago o reversa uno pagado.
Migración
Importa clientes y pedidos históricos terminales desde una plataforma legacy. Cada petición valida el lote y encola un trabajo. Sigue el progreso en el dashboard en Clientes o Pedidos → Migraciones.Migrar clientes
Upsert de clientes desde un sistema legacy
Migrar pedidos
Upsert de pedidos históricos terminales
API Admin vs API Storefront vs API de integraciones
Usa la API que corresponda al actor: los clientes interactúan vía Storefront, la cocina vía Integrations, y tu equipo de operaciones vía Admin.
URL base
Colección de Postman
Descarga todos los endpoints de la API Admin. Configura
client_id y
client_secret, luego ejecuta la solicitud Token para definir bearerToken.Próximos pasos
Token
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