Houd rekening met deze verandering in de Offer API

Nieuws 19 oktober 2021

Om samen een nog beter platform te creëren voor ook de geautomatiseerde partner, doen we soms een kleine aanpassing in de API. In dit geval gaat het om de limieten voor het aantal verzoeken wat via de API koppeling ingestuurd kan worden. Houd hier rekening mee, want het is belangrijk dat je aanbod nog goed doorkomt.

Momenteel staan de limieten, ook wel API Rate limits genoemd,  voor de Offer API op 70 verzoeken per seconde. Vanaf 1 november veranderen de limieten van 70 naar 50 verzoeken per seconde.

In april zijn deze limieten al veranderd van 100 naar 91 verzoeken per seconde als een test. Omdat dit succesvol verlopen is, hebben we deze in september van 91 naar 70 verzoeken verlaagd en is de verlaging van 1 november de laatste stap. We doen dit zodat:

  • Er een beter en stabieler IT platform ontstaat. Deze verandering geeft nog steeds genoeg ruimte om alle nodige aanpassingen aan je aanbod door te voeren.
  • Optimaliseren van de API koppeling belangrijk is en we daarmee met elkaar samen werken voor een stabieler platform.

Hier staat alles op een rijtje voor je

Op 6 september zijn de volgende endpoints veranderd van 91 naar 70 verzoeken per seconde:

  • POST /retailer/offers
  • PUT /retailer/offers/{offer-id}
  • PUT /retailer/offers/{offer-id}/price
  • PUT /retailer/offers/{offer-id}/stock
  • DELETE /retailer/offers/{offer-id}

De volgende endpoints veranderen van 70 naar 50 verzoeken per seconde op 1 november:

  • POST /retailer/offers
  • PUT /retailer/offers/{offer-id}
  • PUT /retailer/offers/{offer-id}/price
  • PUT /retailer/offers/{offer-id}/stock
  • DELETE /retailer/offers/{offer-id}

Geen zorgen

Met de laatste verandering in de limieten (50 verzoeken per seconde), is het nog steeds mogelijk om gemakkelijk het aanbod aan te passen. Hiermee is het namelijk mogelijk om alsnog 4.32 miljoen verzoeken per dag te versturen. Ervaar je problemen met deze limieten en nader je deze terwijl je jouw aanbod aanpast? Maak dan gebruik van de documentatie over het aanpassen van aanbod verzoeken. De limieten op aanpassingen in het aanbod zijn zo ontworpen dat alleen bij een daadwerkelijke verandering in het aanbod er een update verstuurd wordt. Bijvoorbeeld: een aanpassing in een voorraad van 12 stuks, komt niet door als er al bekend is dat er 12 stuks voorraad zijn in het systeem van bol.com.

Als jouw API koppeling goed ingesteld is, zal dit geen gevolgen voor je hebben. Controleer voor de zekerheid de informatie die je terugkrijgt in de headers na elk verzoek hierin wordt namelijk aangegeven hoeveel calls je nog kan maken voordat je de limieten raakt. Je vindt hier meer informatie over rate limits en over rate limit conventions. Neem contact op met jouw technisch contactpersoon als je er niet helemaal uit komt. Meer informatie hierover is te vinden op onze Developers pagina.