Desarrolladores
API de integraciones de Saleya
Leé y cambiá el catálogo, el stock, los pedidos y los clientes de una tienda desde tu sistema, y recibí webhooks cuando algo cambia.
Referencia de la API
Cada endpoint con sus parámetros, campos, respuestas y errores, agrupados por recurso.
Referencia de la API →Especificación OpenAPI
Toda la API en un archivo OpenAPI 3.1 para generar un cliente o validar tus solicitudes, y una colección de Postman con cada solicitud lista para enviar.
Acceso
La API es parte del plan Scale, también durante su prueba gratis. Las aplicaciones y los tokens se crean en el panel de la tienda, y cada token ve solo su tienda.
Tu primera solicitud
- 1
En el panel de la tienda, abrí Configuración → API y webhooks y creá una aplicación con los scopes que necesita: la guía Inicio rápido lo muestra paso a paso.
- 2
Emití un token para la aplicación. Se muestra una sola vez: guardalo junto a los demás secretos de tu sistema. Cómo se rotan y se revocan los tokens está en Aplicaciones, tokens y scopes.
- 3
Llamá a
GET /mecon el token: la respuesta muestra la tienda y los scopes que tiene el token.
curl "https://api.saleya.app/v1/me" \
-H "Authorization: Bearer $SALEYA_API_TOKEN"Errores
Una página por cada tipo de error: cuándo ocurre, qué hacer y el cuerpo de la respuesta.
Errores →Registro de cambios
Cada cambio del contrato de la API por fecha, la política de versiones y un feed Atom para seguirlos.
Registro de cambios →
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.
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.