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.

Cargando el índice de búsqueda…

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.