Wat is een API koppeling en wat doet die voor je webshop?

Wat is een API en wat doet een API koppeling?

Een API is een set afspraken waarmee software met andere software kan praten, in plaats van dat een mens op een scherm klikt. Zie het als het loket van een systeem: je vraagt iets in een vaste vorm, en je krijgt een antwoord in een vaste vorm terug ¹. Een API koppeling gebruikt dat loket om twee systemen aan elkaar te laten werken.

Voor een webshop gaat het meestal om vier soorten gegevens:

• Voorraad. Een verkoop in het ene systeem verlaagt het aantal in het andere. Lees ook hoe je voorraad synchroniseert over kanalen.
• Prijzen. Een prijswijziging op één plek komt overal aan.
• Productgegevens. Titels, beschrijvingen, foto's en eigenschappen gaan van de bron naar de kanalen.
• Bestellingen. Een order komt binnen bij de plek die hem verwerkt en de status of trackingcode gaat terug.

Dat is hetzelfde doel als bij elke webshopkoppeling. Het verschil zit in hoe de verbinding gelegd wordt, en dat staat hieronder.

Push en pull in gewone woorden

Een systeem kan vragen of er iets nieuws is (pull of pollen), bijvoorbeeld elke tien minuten. Het kan ook een seintje krijgen zodra er iets gebeurt (push). Zo'n seintje heet vaak een webhook: het systeem stuurt dan zelf een bericht naar een adres dat jij opgeeft ³. Vragen is eenvoudig, maar je loopt altijd een beetje achter en je stelt vaak voor niets een vraag. Een seintje is sneller, maar jouw kant moet het bericht kunnen ontvangen en verwerken. Veel koppelingen gebruiken allebei.

API, plug-in, CSV-import of kant-en-klare koppeling?

Alle vier brengen gegevens van A naar B. Ze verschillen in snelheid, flexibiliteit en hoeveel werk jij ermee hebt.

Een kant-en-klare koppeling is meestal zelf ook een API koppeling: de aanbieder heeft het werk gedaan, jij hoeft het niet te bouwen. Dat is de gewone keuze zolang het systeem dat je wilt koppelen op de lijst staat. Zie ook het verschil tussen plug-in, tussenplatform en eigen API.

Wat kan er misgaan?

• Limieten. Een API laat maar een bepaald aantal verzoeken per periode toe. Zit je daarboven, dan krijg je de melding "te veel verzoeken" (HTTP 429) en moet je even wachten ². Bij grote catalogi moet je koppeling daar rekening mee houden.
• Toegang. Elke API wil weten wie er vraagt, meestal met een sleutel of token. Sleutels verlopen, worden ingetrokken of lekken. Wie beheert ze?
• Versies. Een API verandert. Een oude versie verdwijnt ooit, en dan stopt een koppeling die niet is aangepast.
• Fouten. Een verzoek kan mislukken door een storing, een time-out of onjuiste data. Een goede koppeling probeert het opnieuw en laat zien wat er niet is gelukt, in plaats van stil te falen.
• Data die niet past. Categorieën, btw-codes en eigenschappen heten overal anders. Iemand moet ze op elkaar afstemmen.

Zo beoordeel je een aanbieder

• Is er openbare documentatie waar je zelf in kunt kijken?
• Gaan gegevens één kant op of beide kanten, en hoe vaak?
• Wat gebeurt er bij een fout, en zie je dat zelf?
• Wie past de koppeling aan als de andere partij zijn API wijzigt?
• Welke limieten gelden voor jouw pakket?

Zelf bouwen of een aanbieder inschakelen?

Zelf bouwen loont als je een proces hebt dat nergens standaard wordt ondersteund, bijvoorbeeld een eigen ERP of een maatwerk kassasysteem, en als je een ontwikkelaar hebt die het ook na de oplevering onderhoudt. Reken op bouwtijd, tests, het afhandelen van fouten en aanpassingen telkens als een API verandert.

Een aanbieder kiezen is slimmer als het gaat om bekende kanalen zoals marktplaatsen of leveranciers. Die API's zijn voor jou niet uniek, dus het werk laat je liever delen met anderen. Ook de combinatie bestaat: een kant-en-klare koppeling voor de standaardkanalen, en een eigen stuk software voor wat daarbuiten valt.

Wat StoreLinkr biedt: koppelingen en een eigen API

StoreLinkr heeft twee kanten, en je kunt ze combineren.

Kant-en-klare koppelingen

In het overzicht van koppelingen staan de marktplaatsen, webshops, leveranciers en magazijnsystemen die StoreLinkr al heeft gekoppeld. Je hoeft daar zelf geen API voor te bouwen. Staat een systeem er niet tussen, dan is het niet beschikbaar; vraag dan eerst na wat mogelijk is. Zie ook webshop koppelen.

De E-commerce API

Voor wat daarbuiten valt, heeft StoreLinkr een RESTful E-commerce API. Daarmee kunnen je ontwikkelaars producten uitlezen en bijwerken, voorraadmutaties doorvoeren en orders ophalen en verwerken. Naast de API ondersteunt StoreLinkr webhooks, zodat je systeem een seintje krijgt bij een nieuwe order of voorraadwijziging in plaats van te blijven vragen. Voor data-uitwisseling zijn JSON, XML en CSV mogelijk. De openbare documentatie staat op api.storelinkr.com.

Je koppelingen met marktplaatsen en webshops blijven gewoon werken terwijl je eigen software via de API daarbovenop draait. Welke limieten gelden, hangt af van je pakket en gebruik. Vraag dat na voordat je een zware koppeling bouwt, en bekijk de prijzen.

Veelgestelde vragen