Desarrolladores
Guías de la API
Cómo se comporta la API de integraciones de Saleya más allá de un endpoint: acceso, sincronización, reintentos, conflictos, límites y webhooks.
Guías
Primeros pasos
- Inicio rápido
Obtené un token en el panel de la tienda y hacé las primeras solicitudes: el token, la tienda y la primera página de productos.
- Aplicaciones, tokens y scopes
Qué puede hacer una aplicación, cómo la limitan los scopes, cómo se emiten, rotan y revocan los tokens y cómo cuidarlos.
- Tienda de desarrollo
Probá la integración en una tienda aparte de tu cuenta: la API no tiene tokens de prueba.
Trabajo con datos
- Paginación y sincronización
Leé los listados página por página y mantené una copia al día con el cursor de sincronización, con los registros eliminados.
- Operaciones masivas
Fijá stock, escribí productos y exportá pedidos por miles con un archivo NDJSON en lugar de una solicitud por registro.
- Webhooks
Suscribí un endpoint a los eventos de la tienda, verificá la firma en PHP, Node.js o Python y manejá los reintentos.
- Contabilidad por API
Cargá la contabilidad de la tienda en tu sistema contable o ERP y mantenela al día: qué impuesto usar, dinero, retenciones y períodos cerrados.
Integraciones confiables
- Errores
Cómo se ve un rechazo, qué significa cada estado y qué errores vale la pena reintentar.
- Idempotencia
Repetí una escritura después de un timeout sin aplicarla dos veces: el encabezado Idempotency-Key.
- Versiones e If-Match
Cambiá un registro sin pisar lo que se cambió en la tienda después de que lo leíste.
- Límites de solicitudes
Cuántas solicitudes pueden enviar una aplicación y una tienda, cómo leer los encabezados de límite y qué hacer ante un 429.
- Versiones de la API
Qué puede aparecer en /v1 sin aviso, qué no cambia nunca y cómo se anuncian las obsolescencias y las versiones nuevas.