Para equipos de plataforma
Referencia de API para socios
Autenticación, respuestas de error e índice de endpoints. Los esquemas técnicos completos se proporcionan durante la incorporación del socio.
Autenticación
Incluya su clave de API en cada solicitud:
Authorization: Bearer <your-api-key> X-API-Key: <your-api-key>
Respuestas de error
Los errores devuelven una estructura JSON consistente con un mensaje legible, un código legible por máquina y detalles opcionales (por ejemplo, errores de validación de campos).
{
"error": "Human-readable message",
"code": "MACHINE_READABLE_CODE",
"details": {}
}Endpoints (v1)
- POST/api/v1/orders
Crear un pedido con artículos y dirección de envío.
- GET/api/v1/orders
Listar pedidos de su plataforma (paginado).
- GET/api/v1/orders/{orderId}
Obtener un pedido individual con artículos y estado actual.
- POST/api/v1/orders/{orderId}/assets
Subir activos de diseño para un pedido.
- GET/api/v1/invoices/{orderId}
Obtener la factura asociada a un pedido.
- POST/api/v1/webhooks
Configurar la entrega de notificaciones de estado para su plataforma.
Esquemas completos de solicitud y respuesta, parámetros de paginación y detalles de firma de notificaciones se proporcionan en su paquete de incorporación de socio. ¿Necesita acceso? Solicite una cotización gratuita y provisionaremos credenciales de sandbox.