Changelog

What changed, and what never will.

The compatibility promise: changes to this API are additive. We add endpoints, we add fields, we add optional parameters. We do not rename or remove published fields, change types, or repurpose existing parameters. If a breaking change ever becomes unavoidable, it ships as a new endpoint next to the old one, and the old one keeps working.

2026-07-31

Webhooks: POST /api/webhooks subscribes an HTTPS endpoint to order.updated and product.updated events. Deliveries are HMAC-signed batches, at-least-once, with a test ping endpoint and per-subscription delivery log.

2026-07-31

Long-lived API keys (sk_live_) for server integrations: no more 30-minute token refresh. Keys are user-bound, provisioned by Storekeeper, shown once and stored hashed. Ask your Storekeeper contact for one.

2026-07-31

New delta endpoints for incremental sync: GET /api/orders/delta and GET /api/products/delta. Start from a `since` timestamp, then follow the opaque `next_cursor` to pull only what changed. No more full drains.

2026-07-31

Launched the recipe cookbook at /api/recipes: task-oriented walkthroughs extracted from production integrations, plus this error catalog and changelog.

2026-07-23

All marketing and guide pages are bilingual (EN/NL). New /api/sdks page with 9 downloadable, generated SDKs (PHP, TypeScript, Python, C#, Java, Go, Rust, Kotlin, Swift). Clean operationIds across the spec.

2026-07-22

The surface grew from 8 to 24 endpoints: orders, products, prices, stock, customers, segments, and the reports family (payments, daily close, product sales). New human guide at /api/guide.

2026-07-20

Financial report turnover rows now carry product_group_code next to product_group_id, so ledger mapping can key on your own codes.

2026-07-09

New reference endpoints: /api/payment-methods (stable type_alias per method type) and /api/turnover-groups.

Changelog

Wat er veranderde, en wat nooit verandert.

De compatibiliteitsbelofte: wijzigingen aan deze API zijn additief. We voegen endpoints toe, we voegen velden toe, we voegen optionele parameters toe. We hernoemen of verwijderen geen gepubliceerde velden, veranderen geen types en hergebruiken geen bestaande parameters. Mocht een brekende wijziging ooit onvermijdelijk zijn, dan verschijnt die als nieuw endpoint naast het oude, en blijft het oude werken.

2026-07-31

Webhooks: POST /api/webhooks abonneert een HTTPS-endpoint op order.updated- en product.updated-events. Leveringen zijn HMAC-gesigneerde batches, minimaal eenmalig bezorgd, met een test-ping-endpoint en een leveringslog per abonnement.

2026-07-31

Langlevende API-sleutels (sk_live_) voor serverintegraties: geen tokenverversing elke 30 minuten meer. Sleutels zijn gebruikersgebonden, uitgegeven door Storekeeper, worden eenmalig getoond en gehasht opgeslagen. Vraag je Storekeeper-contact om een sleutel.

2026-07-31

Nieuwe delta-endpoints voor incrementele synchronisatie: GET /api/orders/delta en GET /api/products/delta. Begin met een `since`-tijdstempel en volg daarna de opake `next_cursor` om alleen de wijzigingen op te halen. Geen volledige exports meer nodig.

2026-07-31

Receptenkookboek gelanceerd op /api/recipes: taakgerichte walkthroughs uit productie-integraties, plus deze foutencatalogus en changelog.

2026-07-23

Alle marketing- en gidspagina's zijn tweetalig (EN/NL). Nieuwe /api/sdks-pagina met 9 downloadbare, gegenereerde SDK's (PHP, TypeScript, Python, C#, Java, Go, Rust, Kotlin, Swift). Nette operationIds in de hele spec.

2026-07-22

Het oppervlak groeide van 8 naar 24 endpoints: orders, producten, prijzen, voorraad, klanten, segmenten en de rapportenfamilie (betalingen, dagafsluiting, productverkoop). Nieuwe gids op /api/guide.

2026-07-20

Omzetregels in het financieel rapport bevatten nu product_group_code naast product_group_id, zodat grootboekmapping op je eigen codes kan sleutelen.

2026-07-09

Nieuwe referentie-endpoints: /api/payment-methods (stabiele type_alias per methodetype) en /api/turnover-groups.