API-update over 2 weken

7 mei 2025 om 10:00

Over twee weken, in het weekend van 24 mei, implementeren we de nieuwe EasyWebshop API. Voor ons minder technisch publiek: de API koppelt uw webshop aan externe platformen zoals betaalproviders, bezorgdiensten en kantoorapplicaties. Hiermee kunt u ook aangepaste rapporten maken, klanten in real-time accepteren of weigeren en verkopen en voorraad synchroniseren met lokale applicaties.

Afbeelding van ontwikkelaars

Dankzij compatibiliteit met algemene praktijken en industriestandaarden wordt het veel eenvoudiger om nieuwe API-koppelingen te maken, mogelijk met behulp van AI-gegenereerde code. Dit neemt een grote financiële drempel weg voor kleine bedrijven die zelf aangepaste koppelingen willen bouwen.

Het inhuren van een ervaren webontwikkelaar blijft mogelijk tijdens de Zomer van webdesign, die we voor de derde keer organiseren en die op 21 juni 2025 van start gaat.

Wijzigingen aan de API

Als u momenteel de API gebruikt, moet u uw koppeling – lichtjes – bijwerken. Als u de API niet gebruikt, kunt u dit saaie technische gedeelte overslaan.

API-machtigingen

Authenticatie met tokens: Wanneer de nieuwe API is geïmplementeerd, wordt aanbevolen een token aan te maken via API-instellingen, de machtigingen in te stellen en de Authorization-headermethode te wijzigen van "Basic" naar "Bearer UW_API_TOKEN". De Basic authenticatie met administratoraccounts blijft functioneel, maar zal tegen het einde van dit jaar worden uitgefaseerd. Authenticatie met het e-mailadres en wachtwoord van het hoofdaccount is niet langer mogelijk.
Standaard JSON: Toen de huidige API in 2012 werd gelanceerd, werd het XML-formaat als standaard gekozen. De nieuwe API zal JSON als standaard gebruiken, maar u kunt nog steeds overschakelen naar XML door de query string "?format=xml" aan de URL toe te voegen.
Compatibiliteit met standaard JSON-LD schema's: Producten zullen waar mogelijk schema.org/Product volgen. De belangrijkste wijziging is dat "product_code" verandert in "productID". Bestellingen zullen schema.org/Order volgen. De belangrijkste wijziging hier is dat "order_code" verandert in "orderNumber".
Vereenvoudigde API-eindpunten: De eindpunten zoals "productlist" zullen niet langer werken. De vier geldige eindpunten zijn: "category", "product", "customer" en "order".
Productfoto's uploaden: Er zal geen aparte methode meer zijn voor het uploaden van foto's. We hebben dit vereenvoudigd en het mogelijk gemaakt om foto's bij te voegen bij het invoegen en bijwerken van producten.
Categorienamen en productnamen en -omschrijvingen: Het wordt mogelijk om categorienamen en productnamen en -omschrijvingen in alle talen in te voeren en bij te werken, zelfs als de taal niet is geactiveerd in de webshop.
Structuur in API Push zal lichtjes verschillen: API Push wordt gebruikt voor het real-time verzenden van klant- en bestelinformatie. De structuur zal een betere compatibiliteit hebben met schema.org/Person en schema.org/Order.
API-koppelingen maken beter gedocumenteerd: Het koppelen van betaalproviders, bezorgdiensten en kantoorapplicaties wordt een stuk eenvoudiger. De nieuwe documentatie zal uitgebreide voorbeelden bevatten om dergelijke koppelingen snel op te zetten.

De nieuwe API zal volledig gedocumenteerd worden op de API-documentatiepagina in alle 20 talen. Onze supportafdeling zal beschikbaar zijn tijdens het implementatieweekend om u snel te helpen met wijzigingen aan uw bestaande implementatie.

Nieuwsberichten

Veelgestelde vragen Contact