feat: add version check app

2026-10-27 00:05:00 +01:00
parent bdb465782d
commit 97572fe459
11 changed files with 140 additions and 4 deletions
@@ -14,6 +14,9 @@ Swagger UI: `http://localhost:3001/api/docs`
 - Register to receive device bearer token (90 days)
 - Include device token in `Authorization: Bearer <token>` header
 - Device ID must match URL parameter
+- Send the app version in an `X-App-Version` header (e.g. `1.4.2+37`, the build number is ignored) on every
+  `/devices/...` call. Without it, or below the minimum version (`MIN_APP_VERSION`), the call fails with
+  `426 app_update_required` before the token is checked: the app must be updated to use the backoffice again

 ## Endpoints

@@ -162,4 +165,5 @@ All `/venues/:venueId/...` routes return `403 venue_forbidden` unless the user b
 - 403 Forbidden
 - 404 Not Found
 - 409 Conflict
+- 426 Upgrade Required (`app_update_required`: the terminal app is too old)
 - 429 Too Many Requests