Saltar al contenido

Spaidoo Connector API v1

Conecta cualquier plataforma con Spaidoo.

Un conector vive dentro de una plataforma de tienda (un módulo, una app, un plugin, un backend headless) y le da a Spaidoo lo que un script solo no puede: el catálogo, el cliente con sesión iniciada y las notificaciones push desde el dominio de la tienda.

  • Especificación pública
  • Cualquier plataforma
  • Comprobación en línea
  1. 01Empieza aquí

    Construye un conector, paso a paso

    Del emparejamiento a una comprobación de conformidad sin fallos: cada paso con su diagrama, el código mínimo y cómo saber que funciona.

    Empezar la guía
  2. 02

    La especificación

    El contrato completo: emparejamiento, catálogo, identidad, llamadas firmadas y lo que el conector imprime en la tienda.

    Leer la especificación
  3. 03Partners

    Comprobación de conformidad

    En el área de partners compruebas en línea una instalación de prueba con tu conector, capacidad por capacidad, con cada fallo enlazado a su sección.

    Ir al área de partners

Cómo encaja

Tu conector, entre la tienda, el navegador y Spaidoo.

El conector declara las capacidades que implementa y Spaidoo actúa según esa declaración, nunca según el nombre de la plataforma. Por eso cualquier plataforma puede construir uno.

Lo mínimo es el emparejamiento, el handshake y el feed de productos, más el script en la tienda. Todo lo demás son piezas independientes que se declaran y se comprueban por separado.

La imagen completa: tu conector entre la tienda, el navegador del cliente y SpaidooNavegador del cliente. Plataforma de tienda + tu conector. Spaidoo. Página de la tienda con el widget. Notificaciones push desde el dominio de la tienda. Páginas de la tienda storefront.saveAnchors. Ruta de identidad identity. Service worker de push push. Feed de productos catalog.feed. Ruta customers customers. Ruta de verificación domainVerification. Llamadas a Spaidoo handshake · catalog.changes customerErase · wishlistImport. Loader del widget scriptUrl. Sync de Spaidoo. API de Spaidoo /connector/v1. la página carga el widget. script, SpaidooConfig, anclajes de guardado. ¿quién navega?. lo registra. lo lee cada día. llamada firmada. lee el código. Bearer <apiKey>Navegador del clientePlataforma de tienda + tu conectorSpaidooPágina de la tiendacon el widgetNotificaciones pushdesde el dominio de la tiendaPáginas de la tiendastorefront.saveAnchorsRuta de identidadidentityService worker de pushpushFeed de productoscatalog.feedRuta customerscustomersRuta de verificacióndomainVerificationLlamadas a Spaidoohandshake · catalog.changescustomerErase · wishlistImportLoader del widgetscriptUrlSync de SpaidooAPI de Spaidoo/connector/v1la página carga el widgetscript, SpaidooConfig,anclajes de guardado¿quién navega?lo registralo lee cada díallamada firmadalee el códigoBearer <apiKey>
Las flechas van de quien pregunta a quien responde. Las capacidades están donde viven: rutas que sirve la tienda, lo que imprime en sus páginas y las llamadas que el conector hace a Spaidoo.

Para partners de Spaidoo

Pregunta al asistente.

Los partners con acceso al área de desarrolladores tienen un asistente que conoce la especificación a fondo. Le puedes pasar un informe de conformidad y te dice por qué falla y cómo arreglarlo.

  • Respuestas que enlazan las secciones de la especificación.
  • Un informe de conformidad, directo a la conversación.
  • Tus conversaciones se guardan.
Abrir el asistente

Asistente de la Connector API

Responde a partir de la especificación

La comprobación de identidad dice que mi aserción ha caducado. ¿Por qué?

Una aserción vive 60 s como mucho (exp - iat) y Spaidoo tolera 30 s de desfase de reloj. Si la ruta la cachea o el reloj del servidor va desviado, llega caducada: fírmala de nuevo en cada petición, con Cache-Control: no-store, y mantén el reloj en hora.

§5.1§5.2

Conversación de ejemplo