Koppeling met je eigen website

Toon de clubshop-catalogus op je eigen website, met een link naar de bestelpagina.

Wanneer gebruik je dit?

Heb je een eigen website (naast de app) en wil je daar laten zien wat er in de clubshop te koop is? Met een API-sleutel haalt je website automatisch de actuele catalogus op — geen handmatig bijwerken meer nodig als er een nieuw artikel bijkomt of de voorraad wijzigt.

Dit vereist wel dat de winkel eerst publiek staat (zie het artikel over de publieke winkel) — zonder dat zou de catalogus artikelen tonen die nergens naar toe linken.

Een sleutel aanmaken

1. Ga naar Winkelinstellingen → Koppeling met je eigen website.
2. Klik op API-sleutel genereren.
3. Kopieer de sleutel direct — om veiligheidsredenen wordt hij daarna nooit meer getoond. Kwijt? Genereer gewoon een nieuwe (de oude stopt dan met werken).
4. Zet Koppeling actief aan en sla op.

Wat je website ermee doet

Je website (of de ontwikkelaar daarvan) haalt de catalogus op via het endpoint dat op de instellingenpagina staat, met de sleutel erbij (als Authorization: Bearer-header, of als ?key=-parameter in de URL). De catalogus komt terug als JSON: bestelrondes met hun artikelen, en de doorlopende artikelen — allemaal alleen wat je zelf op "Publiek" hebt gezet. Elk artikel heeft een directe link naar de bestelpagina in de app; klikt een bezoeker daarop, dan komt hij op de volledige (betaal-)checkout terecht. Je hoeft op je eigen website dus geen bestelproces te bouwen — alleen de catalogus te tonen.

Sleutel kwijt of gelekt?

Genereer direct een nieuwe sleutel — de oude werkt dan meteen niet meer. Werk daarna de sleutel op je eigen website bij.