API changelog
Every change to the UnitGlide API that a client can observe, newest first. Deprecated endpoints keep working; when one is ever switched off, the date will be announced here first.
v1: Versioned API introduced
- Added /api/v1/convert and /api/v1/units. Same parameters, same validation and the same numbers as the unversioned endpoints they replace.
- Every v1 response now carries a license field (CC BY 4.0) and an attribution field, on success and on error alike.
- Added /api/v1/factors: the conversion factor to each category base unit for every unit, with an exactness flag, a note on how the factor is derived and the defining authority. It is the machine-readable version of the methodology page.
- Added /api/openapi.json, an OpenAPI 3.1 description of the three v1 endpoints.
- The legacy /api/convert and /api/units are now deprecated. They keep working and their response shape is unchanged; they only gained a Deprecation header and a Link header pointing at the successor endpoint.
Version policy
The response shape of a released version is additive only: new fields may appear, existing fields will not change meaning or disappear. Anything that would break a client gets a new version path instead. Legacy endpoints without a version prefix (/api/convert and /api/units) are deprecated but supported, and they return a Deprecation header plus a Link header naming their successor.
The full contract lives at /api/openapi.json. Back to the developer documentation.