Inicio rápido

De una terminal vacía a la primera página de productos en unos minutos. Necesitás el panel de la tienda con permiso para gestionar la API y un plan que la incluya.

Cargando el índice de búsqueda…

Inicio rápido

Obtené un token

  1. En el panel de la tienda, abrí Configuración → API y webhooks y creá una aplicación. Ponele el nombre de tu sistema, por ejemplo ERP sync.
  2. Elegí los scopes que necesita la aplicación, por ejemplo catalog:read e inventory:write, y ninguno más: mirá aplicaciones, tokens y scopes.
  3. Emití un token para la aplicación. Se muestra una sola vez: copialo al almacén de secretos de tu sistema.

Los ejemplos leen el token de la variable de entorno SALEYA_API_TOKEN. Cada solicitud lo envía en el encabezado Authorization: Bearer; un token en la dirección se rechaza.

Verificá el token

GET /me funciona con cualquier token y dice en nombre de quién habla: la aplicación, sus scopes y locales, y sus límites de solicitudes.

Solicitud
curl "https://api.saleya.app/v1/me" \
  -H "Authorization: Bearer $SALEYA_API_TOKEN"
Respuesta
HTTP/1.1 200 OK

{
  "app": {
    "id": 12,
    "name": "ERP sync",
    "description": null,
    "scopes": [
      "catalog:read",
      "catalog:write",
      "inventory:read",
      "inventory:write",
      "orders:read"
    ],
    "allowed_ips": [
      "203.0.113.10"
    ],
    "all_locations": true,
    "location_ids": [],
    "created_at": "2026-11-02T09:15:00Z"
  },
  "token": {
    "name": "Production",
    "prefix": "saleya_at_3kQ9",
    "expires_at": null
  },
  "store_id": 7,
  "rate_limits": {
    "app": {
      "per_minute": 300,
      "burst": 100
    },
    "store": {
      "per_minute": 1200,
      "burst": 400
    }
  }
}

Un 401 acá significa que el token no fue aceptado: revisá que se haya copiado entero. El type de la respuesta dice qué está mal exactamente — mirá errores.

Leé la configuración de la tienda

GET /store devuelve con qué se leen las demás respuestas:

  • el dinero es un entero en las unidades menores de currency: 129900 en ARS es 1.299,00; los campos que terminan en _micro, como los costos, están en millonésimas de unidad menor;
  • los momentos van en UTC, RFC 3339: 2026-11-11T14:30:00Z; los días y horarios de la tienda siguen su timezone;
  • los nombres y descripciones son objetos por idioma, {"es": "…", "en": "…"}, en los idiomas de supported_locales.
Solicitud
curl "https://api.saleya.app/v1/store" \
  -H "Authorization: Bearer $SALEYA_API_TOKEN"
Respuesta
HTTP/1.1 200 OK

{
  "id": 7,
  "name": {
    "es": "Almacén Norte",
    "en": "North Grocery"
  },
  "currency": "ARS",
  "timezone": "America/Argentina/Buenos_Aires",
  "country": "AR",
  "default_locale": "es",
  "supported_locales": [
    "es",
    "en"
  ],
  "marketing_consent_mode": "opt_in"
}

Leé los productos

Un listado devuelve una página de registros en data y el cursor de la página siguiente. Pedí la primera página de productos:

Solicitud
curl "https://api.saleya.app/v1/products?limit=50" \
  -H "Authorization: Bearer $SALEYA_API_TOKEN"

Para mantener una copia del catálogo, leé el listado hasta el final y guardá el cursor de sincronización de la última página: paginación y sincronización muestra el ciclo.

Próximos pasos

  • Enviá un Idempotency-Key con cada escritura, para que un reintento no la aplique dos veces — idempotencia.
  • El cambio de un registro con versión necesita su ETag en If-Match — versiones e If-Match.
  • Suscribite a eventos en lugar de consultar una y otra vez — webhooks.
  • Probá contra una tienda aparte de tu cuenta — tienda de desarrollo.
Siguiente guíaAplicaciones, tokens y scopes