Bouw je eigen API-integratie

Wanneer bouw je een eigen integratie?

De meeste resellers gebruiken onze Shopify-app of WooCommerce-plugin en komen nooit aan de API toe. Bouw een eigen integratie als:

• Je op een platform zit dat geen Shopify of WooCommerce is (Magento, eigen ERP, headless commerce, etc.).

• Je eigen logica nodig hebt — routeringsregels, prijsengines of data-verrijking — die de plugins niet bieden.

• Je data wilt synchroniseren naar een back office of datawarehouse naast je webshop.

Wat de API biedt

• REST API — standaard HTTP-endpoints met JSON-payloads. Geen eigen SDK vereist.

• Product-, voorraad- en bestelendpoints — lees de catalogus, stuur bestellingen door en ontvang voorraadwijzigingen.

• Ontwikkelaarsdocumentatie — authenticatie, endpoints, request/response-structuur, rate limits en best practices.

• Sandboxomgeving — op aanvraag, zodat je kunt testen zonder live data aan te raken.

• Technische ondersteuning — techsupport@everspring.app voor implementatievragen.

Stap 1 — Genereer je API-sleutel

1. Log in op je Everspring back office als reseller.

2. Ga naar Instellingen → API-gebruikers.

3. Klik op Nieuwe API-gebruiker aanmaken en geef het een naam die duidelijk maakt waarvoor je het gebruikt (bijv. "Magento prod", "WooCommerce staging").

4. Klik op Opslaan. Everspring genereert een API-sleutel en toont die op het scherm.

Stap 2 — Sla de sleutel veilig op

• Sla de sleutel op als een secret in de omgeving van je integratie (1Password, AWS Secrets Manager, Vault, of het equivalent van jouw platform). Zet hem nooit in versiebeheer.

• Geef elk afzonderlijk systeem zijn eigen API-gebruiker — lekt er één sleutel, dan trek je die in zonder de anderen te verstoren.

• Je beheert en trekt bestaande API-gebruikers in via Instellingen → API-gebruikers, maar een sleutel die nooit is gekopieerd kun je niet terughalen.

Stap 3 — Verbinden en synchroniseren

Wijs je integratie naar de Everspring API en gebruik de sleutel als authenticatieheader. De ontwikkelaarsdocumentatie beschrijft alle endpoints; de gebruikelijke volgorde is:

1. Haal de catalogus op — lees producten, varianten en metadata uit.

2. Koppel SKU's — elk product dat je ophaalt moet aan een Everspring-SKU aan jouw kant worden gekoppeld; de SKU is de basis voor voorraadwijzigingen en het doorsturen van bestellingen.

3. Abonneer je op voorraadwijzigingen — de voorraad wordt ongeveer elk uur vernieuwd. Verwerk die wijzigingen in je storefront zodat je niet oververkoopt.

4. Stuur bestellingen door — stuur bestellingen met Everspring-SKU's door voor fulfilment.

Hoe voorraadsync werkt

• Voorraadwijzigingen aan de Everspring-kant komen binnen ongeveer een uur in jouw integratie terecht.

• Leveranciers zijn zelf verantwoordelijk voor het actueel houden van hun voorraad in Everspring. Is de voorraad bij een leverancier niet correct, dan ziet jouw integratie ook de verkeerde waarde.

• Richt je storefront zo in dat Everspring de enige bron van waarheid is voor beschikbare voorraad — cache de voorraad niet langer dan je synchronisatie-interval.

Vraag een sandbox aan

Voor de meeste serieuze integraties raden we aan eerst tegen een sandbox te bouwen. Stuur een mail naar techsupport@everspring.app met een korte omschrijving van je integratie en we zetten er een voor je op. Sandboxes spiegelen de structuur van de productie-API, maar staan los van echte bestellingen en voorraad.