Introducción
Elige la guía según la API y la tarea de tu integración.
Última actualización:
Admin, Storefront, Auth y UCP resuelven autenticación y contexto de forma distinta. Usa la referencia del endpoint como contrato y estas guías para implementar el flujo completo.
Elige la API
| API | Para qué sirve | Contexto principal |
|---|---|---|
| Admin | Gestionar catálogo, pedidos, inventario y configuración. | Token OAuth y contexto de tienda o vendedor. |
| Storefront | Leer la tienda y ejecutar flujos del comprador. | Header x-Store-Domain; algunas operaciones también requieren sesión. |
| Auth | Emitir tokens y gestionar cuentas de usuario. | Aplicación OAuth o sesión de usuario, según la operación. |
| UCP | Integrar agentes con catálogo, carrito y checkout. | Perfil UCP y OAuth o API key, según la operación. |
El endpoint de token de Auth usa un formulario OAuth. No asumas que sus errores o su cuerpo coinciden con los endpoints de Admin.
Empieza aquí
Configura una integración
Crea una aplicación OAuth, obtén un token y llama a Admin.
Autenticación
Usa client credentials, conserva el secreto y renueva el acceso.
Contexto y jerarquía
Resuelve organización, tienda y vendedor en cada API.
Implementa el flujo
Paginación
Distingue cursor, page/pageSize y consultas con solo limit.
Eventos de webhook
Elige eventos, valida entregas y procesa reintentos.
Opera con seguridad
Errores
Distingue Problem Details, errores OAuth y fallos de infraestructura.
Códigos de error
Consulta los códigos documentados y el estado que los produce.
Límites de uso
Maneja límites por tasa, concurrencia y respuestas 429.
Herramientas para agentes
Combina Markdown y OpenAPI sin inventar campos o permisos.
Antes de empezar
- Para una integración de Admin, crea una aplicación OAuth en el panel. La
aplicación entrega
client_idyclient_secret; una API key es otra credencial y no los reemplaza. - Define la tienda correcta. En el gateway central, Storefront usa
x-Store-Domaincon el slug o un dominio configurado. Admin obtiene el contexto de los claims del token. - Revisa la página del endpoint antes de programar. Allí se definen autenticación, parámetros, paginación, cuerpo y respuestas.