Gebruik je Spaidoo?Open je universele bibliotheek.
Connector API

Koppel je platform aan Spaidoo

Draait je webshop op een ander platform, of maak je e-commercesoftware? Met de Connector API kan elk platform een eigen Spaidoo-connector hebben.

Specificatie v1 gepubliceerd · documentatie in het Engels en Spaans

Wat een connector doet

Vijf onderdelen. Geen enkel hangt af van een bepaald platform.

  • 01

    Koppeling van de webshop

    De webshop meldt zich aan vanuit zijn paneel, krijgt zijn sleutel en koppelt. Ook het afmelden en de instellingen van de widget.

  • 02

    Klantidentiteit

    Is de klant ingelogd in de webshop, dan bevestigt de connector dat met een HMAC-handtekening en wacht zijn lijst op hem.

  • 03

    Catalogus

    Een feed in Google Merchant-formaat per taal, met prijzen in elke valuta. Spaidoo leest hem en houdt hem actueel.

  • 04

    Etalage

    Het script van de widget en de opslaan-knoppen, gemarkeerd met data-*-attributen. Niets in de checkout.

  • 05

    Ondertekende aanroepen

    Heeft Spaidoo iets van de webshop nodig, zoals de e-mails van zijn klanten, dan is de aanroep ondertekend en voorzien van een tijdstempel.

Open standaarden

  • JSON via HTTPS

    Alle aanroepen tussen de connector en Spaidoo.

  • HMAC-SHA256

    Om de identiteit van de klant en de aanroepen van Spaidoo naar de webshop te ondertekenen.

  • Google Merchant

    Het catalogusformaat dat bijna elk platform al kan maken.

  • data-*-attributen

    Om de widget te vertellen waar de opslaan-knoppen komen, zonder het thema aan te raken.

Zo begin je

  1. 1

    Lees de handleiding

    Stap voor stap, met diagrammen en codevoorbeelden: wat de connector doet en in welke volgorde.

    Start de handleiding
  2. 2

    Koppel een testwinkel

    Een installatie van je platform die via internet bereikbaar is, met jouw connector gekoppeld aan Spaidoo.

  3. 3

    Doorsta de controle

    Die toetst je connector aan de specificatie en vertelt wat er misgaat en in welke sectie.

  4. 4

    Vraag hulp wanneer nodig

    Spaidoo-partners met toegang hebben een assistent die de specificatie kent. En wij staan aan de andere kant.

Veelgestelde vragen

01Kan ik Spaidoo zonder connector gebruiken?
Ja. De widget werkt in elke webshop met één regel code. De connector voegt de klantidentiteit, de gesynchroniseerde catalogus en de communicatie toe.
02Waar is de technische documentatie?
Op developers.spaidoo.com: de volledige specificatie v1, een stap-voor-stap-handleiding en de online controle. In het Engels en Spaans.
03Krijg ik hulp tijdens het bouwen?
Ja. Spaidoo-partners kunnen toegang krijgen tot een assistent die de specificatie en de referentieconnector kent en het controlerapport leest. En je kunt ons altijd schrijven.

Welk platform wil je koppelen?

Bekijk de documentatie