Versioning and calculation changes

  • API version: every path starts with /v1. Within v1 we only add: new operations, new optional parameters, new response fields. Removing or renaming anything needs a new version, announced in advance.
  • Engine version: every JSON response carries meta.engine_version. It changes when a calculation changes, even if the response shape does not.
  • Calculation changes are listed separately in the changelog (with an RSS feed): what changed, why, and which results move. Store engine_version with results you keep, so you know which rules produced them.