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:
- Language list - Displays supported languages as radio options.
- Selected state - Highlights the active language.
- Apply button
Workflow
This flow starts when the Language Selection screen is open.
- Open the Language Selection screen from Account → Language.
- Select a language.
- Confirm selection.
Validations
These rules determine selection and submission behavior.
| Scenario | App behavior | SDK output |
|---|---|---|
| No existing language preference. | Select default language. | language = en. |
| Supported language selected. | Enable Apply action. | Selection state updated. |
| Apply selected with no change. | Close screen without update. | No state change. |
| Unsupported language value provided. | Reject request. | Validation error returned. |
Actions
| Scenario | App behavior | SDK output |
|---|---|---|
| Language selection confirmed. | Update UI language across screens. | Session language updated. |
| Navigation occurs without confirmation. | Retain current language. | No state change. |
| Language updated during session. | Apply language immediately. | Updated session state returned. |
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. |