BoekwinkeltjesVerkoperApi (3.7)

API voor Boekwinkeltjes.nl

Test omgeving (endpoint): https://api-zandbak.boekwinkeltjes.nl/webservice/v1/

De zandbak maakt geen verzendlabels aan: POST /packages maakt het pakket wel aan, maar label in de response is altijd null en GET /packages/{id}/label geeft altijd een 404.

Live omgeving (endpoint): https://www.boekwinkeltjes.nl/webservice/v1/

  • Requests zijn rate-limited (per API-key): maximaal 300 requests per minuut en 40.000 per dag. Boven een limiet volgt een 429 met een Retry-After-header met het aantal seconden tot het venster opnieuw begint. Het bestellingenoverzicht (GET /orders) mag 1x per 5 minuten per URL worden opgehaald, een losse bestelling (GET /orders/{orderId}) 1x per half uur. Gebruik voor nieuwe bestellingen en betalingen de webhook in plaats van pollen.
  • De API en configuratie worden gebouwd in boekwinkeltjes.nl
  • Boeken die worden toegevoegd/gewijzigd/gedelete worden in een queue gezet en verwerkt door de uploadfunctie
  • Boeken via bestaande IdentityMap
  • Webhook-melding bij nieuwe bestellingen, betalingen en berichten, zie het hoofdstuk webhook onderaan

Changelog

  • 3.7 (20 november 2026): POST /payments/links accepteert amount 0 voor een betaalverzoek met alleen verzendkosten, en shippingcosts onder de 1 euro. Samen moeten ze boven de transactiekosten per betaling liggen, anders volgt status 400 in de body.
Overview
Servers
Live omgeving
https://www.boekwinkeltjes.nl/webservice/v1
Test omgeving (zandbak)
https://api-zandbak.boekwinkeltjes.nl/webservice/v1
Localhost
https://boekwinkeltjes.localhost/webservice/v1