Nieuws 8 augustus 2023

Uitbrengen en uitzetten API-versies wordt herzien

& automatische omleiding van API v7 naar v8

Aanpakken doen we samen. Daarom helpen we jou als verkooppartner succesvol te ondernemen en je ambities waar te maken. En om het je zo makkelijk mogelijk te maken, kan je gebruik maken van de bol.com Retailer API, waarmee je gemakkelijk een automatische koppeling kan maken tussen je eigen (webwinkel)systeem en je bol.com verkoopaccount. Zo kun je je verkopen via bol.com vanuit één plek beheren. Om dit proces nog efficiënter in te richten, herzien we de de manier waarop we nieuwe API-versies uitbrengen en aanzetten. Ook worden partners die nog Retailer API v7 gebruiken per 1 november automatisch omgeleid naar API v8. In dit nieuwsbericht lees je hier meer over.

Uitbrengen en uitzetten API-versies wordt herzien 
In 2020 hebben we de ‘Retailer API lifecyclegeïntroduceerd: een vast ritme waarin enerzijds nieuwe APIversies met nieuwe functionaliteiten geïntroduceerd worden en anderzijds oude versies verwijderd worden. Elke 6 maanden komt er een nieuwe APIversie uit en oude versies worden na 19 maanden uitgefaseerd. Door regelmaat te brengen in het uitbrengen en uitzetten van APIversies, kun je sinds 2020 de overstap naar een nieuwe versie goed plannen.  
 
Naast het positieve aspect van de huidige API lifecycle, hebben we ook teruggekregen dat het verplicht overstappen naar een nieuwe API-versie in 19 maanden soms veel tijd kost, en dat de nieuwe functionaliteiten niet altijd gebruikt worden. Daarom herzien we de manier waarop we de nieuwe API-versies uitbrengen en uitzetten. Dat betekent dat partners die geen interesse hebben in nieuwe functionaliteiten in de toekomst alleen nog hoeven over te stappen naar een nieuwe versie wanneer er een grote verandering (breaking change) is. Komend half jaar wordt de nieuwe versioneringsstrategie verder uitgewerkt en geïmplementeerd. Zodra hier meer over bekend is, delen we dit via het Partnerplatform en developers.bol.com.  
 
Automatische omleiding van API v7 naar v8 
Gebruik je API v7? Dan word je als partner per 1 november automatisch omgeleid naar API v8 (tot 1 mei 2024). Dit betekent dat je voorlopig nog gebruik kunt blijven maken van API v7 en je per 1 november antwoord zult krijgen van onze API v8. Begin volgend jaar wordt bekend gemaakt hoe de nieuwe werkwijze er precies uitkomt te zien en vanaf welke APIversie we geen periodieke update meer uitbrengen. Hierna kunnen API v7 gebruikers in een keer overstappen naar deze ‘base versie. Dit scheelt aankomende maanden een extra overstap. Kijk voor de zekerheid in de migratiegids voor meer informatie hoe de redirect technisch is zijn werk gaat.