Authenticatie

Maak een sleutel in je account. Verstuur die uitsluitend vanaf je server in de Authorization-header. Elke sleutel kan direct worden ingetrokken.

Authorization: Bearer YOUR_REKENBOX_API_KEY
Content-Type: application/json

Een berekening uitvoeren

POST https://rekenbox.winstwaker.nl/api/v1/calculate

{
  "tool": "btw",
  "input": { "amount": "100", "rate": "21", "mode": "add" },
  "options": { "year": 2026, "version": "2026.1", "locale": "nl" }
}

Alle invoervelden zijn strings. Geldbedragen in de invoer zijn euro’s; resultaatvelden van het type money zijn gehele centen als string. De response bevat result en usage.

Tools en velddefinities

GET https://rekenbox.winstwaker.nl/api/v1/tools

Dit geeft de ondersteunde tool-ID’s, velden, selectiewaarden, grenzen, jaren, versies, bronnen en uitgangspunten. Een onbekend jaar of een onbekende versie wordt afgewezen; Rekenbox vervangt die niet stilzwijgend.

Bulk

POST https://rekenbox.winstwaker.nl/api/v1/bulk

{ "calculations": [
  { "tool": "btw", "input": { "amount": "100" } },
  { "tool": "iban", "input": { "iban": "NL91ABNA0417164300" } }
] }

Maximaal tien berekeningen per verzoek en 10 MB aan bronbestanden. Iedere uitkomst heeft ok en result of error. Fouten tellen niet mee voor het quotum. De verwerking stopt wanneer de tijdslimiet is bereikt; onbewerkte onderdelen melden bulk_time_limit.

Quota en fouten

Quota worden per betalend account en kalendermaand in UTC gedeeld door alle sleutels en bulkcontroles. Maximaal 120 verzoeken per sleutel per minuut. Geen automatische meerkosten. Bronbestanden gaan in input.file als XML- of CSV-tekst; ze worden na verwerking niet bewaard. Bewaar zelf de resultaatversie bij je toepassing.