Nieuwe versiebeheerstrategie voor Retailer API
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.
Zoals eerder aangekondigd is er naar aanleiding van jullie feedback de afgelopen tijd gewerkt aan een nieuwe manier om nieuwe functionaliteiten op de Retailer API uit te brengen en oude functionaliteit uit te faseren. Door deze nieuwe ‘versiebeheerstrategie’ hoef je alleen updates uit te voeren als er ook echt iets verandert in jouw implementatie.
De Retailer API v10, die 1 oktober uitgekomen is, is de start voor deze nieuwe versiebeheerstrategie. Dit heeft als grote voordeel dat je in de toekomst geen aanpassingen hoeft te doen als er voor jou niks verandert. Daarnaast kunnen wij nu vaker nieuwe functionaliteit uitbrengen dan tot nu toe het geval was.
In plaats van halfjaarlijks een nieuwe versie te introduceren voor de gehele Retailer API, gaat de versionering nu plaatsvinden op een lager niveau. Daardoor wordt het onderhoud van je API koppeling makkelijker. Zo zou bijvoorbeeld de resource ‘Orders’ op v10 kunnen blijven, terwijl ‘Offers’ naar v11 gaat.
Een resource gaat pas naar een nieuwe versie wanneer er:
- Een ‘breaking change’ is op een endpoint binnen een resource
- Een endpoint binnen een resource geheel verdwijnt.
De oude versie van de resource zal dan nog minimaal een jaar worden ondersteund.
Deadlines laatste migratie gehele Retailer API
We adviseren natuurlijk om zo snel mogelijk voor al je API-activiteit naar de Retailer API v10 over te stappen. Lukt dat nu niet? Houd er dan rekening mee dat oudere versies uitgefaseerd worden. Zorg dus dat je in ieder geval rekening houdt met de volgende tijdslijnen:
- Retailer API v7 en v8 zijn nog te gebruiken tot 1 mei 2024
- Retailer API v9 is nog te gebruiken tot 1 november 2024
Hoe werkt het overstappen?
Afhankelijk van welke versie je momenteel gebruikt hebben we een overzicht gemaakt van de meest belangrijke veranderingen tussen de oudere versies en de v10: link. V
Als je vragen hebt over de migratie kan je contact met ons opnemen via retailer-api-migratie@bol.com