Language Selection
Use the Language Selection screen to change the display language of the Air Doctor app.
The screen updates all supported user interface text for the active session and returns the user to the previous screen after confirmation.
This screen includes:
- A list of supported languages displayed as radio buttons.
- The currently active language selected by default.
- A single confirmation control to apply the selected language.
- Immediate UI refresh after confirmation.
- Session-level persistence of the selected language across screens.
Workflow
Change Application Language
- From the main navigation, open Account.
- Select Language.
- Select one language from the list.
- Select Apply.
- The app refreshes all visible UI text and closes the screen.
Validations
These scenarios describe how the app validates the Language Selection screen and what the integrator can expect.
| Scenario | App Behavior | SDK Output | Example |
|---|---|---|---|
| The user opens the screen with no prior language preference. | The app selects English by default. | Language value resolved to en. | — |
| The user selects a supported language. | The app enables the Apply button. | No request sent until confirmation. | — |
| The user selects Apply without changing the language. | The app closes the screen without UI updates. | No update set returned. | — |
| The user submits an unsupported language value. | The app rejects the request. | Validation error in the response. | — |
Actions
These scenarios describe how the app responds to actions on the Language Selection screen and what the SDK returns.
| Scenario | App Behavior | SDK Output | Example |
|---|---|---|---|
| The user selects a language and confirms. | The app updates all UI labels and menus immediately. | Update set that refreshes the current page content. | — |
| The user navigates back without confirmation. | The app preserves the existing language. | No update set returned. | — |
| The user changes language during an active session. | The app applies the language across all open screens. | Server-side confirmation with updated session state. | — |
Endpoint Resources
Open Language Selection
PUT
/account/change-language
Produces the Language Selection screen for the authenticated user session.
The response body includes:
- List of supported languages.
- Current language selection.
- Confirmation control.
UI Element Types
| Level | Reference | Type | Value | Placement |
|---|---|---|---|---|
| 1 | choose-language | Regular | Choose your desired app language: | |
| 1 | en | Radio | English | |
| 1 | language~en-gb | Radio | English UK | |
| 1 | language~he | Radio | Hebrew | |
| 1 | language~es | Radio | Spanish | |
| 1 | language~de | Radio | German | |
| 1 | language~zh | Radio | Chinese | |
| 1 | language~nl | Radio | Dutch | |
| 1 | language~fr | Radio | French | |
| 1 | language~ru | Radio | Russian | |
| 1 | language~ja | Radio | Japanese | |
| 1 | apply | Button | Apply |
Apply Language Change
POST
/account/change-language
Returns an update set that applies the selected language to the active session and refreshes all visible UI text.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
language | Enum | Yes | Language code. Supported values: en, en-gb, he, es, de, zh, nl, fr, ru, ja |
Errors
| Code | Description |
|---|---|
FIELDS_VALIDATION_ERROR | One or more required fields are invalid. |