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
429met eenRetry-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
Overview
URLBoekwinkeltjes
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