# Gérer les langues de l'application

> Ajouter une langue à votre application, choisir sa langue par défaut et retirer une langue, depuis la console ou par l'API publique.

Les langues de l'application sont celles dans lesquelles elle peut s'afficher. Ajoutez-en une avant d'en saisir les traductions, et désignez celle qui s'applique quand aucun autre réglage ne choisit pour l'utilisateur.

## Avant de commencer

- Le français et l'anglais sont toujours présents : vous ne pouvez pas les retirer.
- Repérez le code ISO 639-1 de la langue, en deux lettres minuscules : `es` pour l'espagnol, `de` pour l'allemand, `it` pour l'italien.

## Ajouter une langue

::::tabs{sync="voie"}
:::tab{label="Console"}
1. Dans la barre latérale, ouvrez **Mes Apps**, choisissez votre application, puis **Paramétrage**.
2. Ouvrez l'onglet **Langues**. La carte **Langues supportées** liste les langues actuelles.
3. Cliquez sur **Ajouter une langue**.
4. Saisissez le **Nom de la langue**, par exemple `Español`, puis le **Code ISO**, par exemple `es`. La fenêtre indique **Langue existante selectionnee** si la langue existe déjà dans le référentiel, ou **Nouvelle langue (sera creee dans le systeme)**.
5. Cliquez sur **Ajouter**.

Résultat : le message « Langue "Español" ajoutee » s'affiche et la langue rejoint la liste.
:::
:::tab{label="API"}
Retrouvez la langue dans le référentiel, ou créez-la, puis rattachez-la à l'application.

```bash
# 1. Retrouver ou créer la langue
curl -X POST "https://api.wakastart.app/api/languages/find-or-create" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "code": "es", "name": "Español" }'

# 2. La rattacher à l'application (identifiant UUID de l'application)
curl -X POST "https://api.wakastart.app/api/app-languages" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "appId": "6a1e0c2b-0000-4000-8000-0000000000aa", "languageId": "9b2d4e6f-0000-4000-8000-000000000003" }'
```

```ts
const API = "https://api.wakastart.app/api";
const headers = {
  Authorization: `Bearer ${accessToken}`,
  "Content-Type": "application/json",
};

const language = await fetch(`${API}/languages/find-or-create`, {
  method: "POST",
  headers,
  body: JSON.stringify({ code: "es", name: "Español" }),
}).then((r) => r.json());

const link = await fetch(`${API}/app-languages`, {
  method: "POST",
  headers,
  body: JSON.stringify({ appId: "6a1e0c2b-0000-4000-8000-0000000000aa", languageId: language.id }),
});
if (link.status === 409) console.log("Langue déjà proposée par l'application");
```

Réponse attendue de la première requête :

```json
{ "id": "9b2d4e6f-0000-4000-8000-000000000003", "code": "es", "name": "Español", "isDefault": false }
```

La seconde répond `201 Created`. Si la langue est déjà rattachée, elle répond `409` avec le message « This language is already added to the app ».
:::
::::

## Choisir la langue par défaut

::::tabs{sync="voie"}
:::tab{label="Console"}
1. Dans l'onglet **Langues**, sur la ligne de la langue, cliquez sur l'icône **Definir comme langue par defaut**.

Résultat : le message « Langue par defaut mise a jour » s'affiche. L'ancienne langue par défaut reste proposée.
:::
:::tab{label="API"}
```bash
curl -X PUT "https://api.wakastart.app/api/app-languages/app/6a1e0c2b-0000-4000-8000-0000000000aa/language/9b2d4e6f-0000-4000-8000-000000000003/default" \
  -H "Authorization: Bearer $ACCESS_TOKEN"
```

La réponse renvoie le rattachement avec `"isDefault": true`. Une seule langue par défaut existe par application.
:::
::::

## Retirer une langue

::::tabs{sync="voie"}
:::tab{label="Console"}
1. Dans l'onglet **Langues**, sur la ligne de la langue, cliquez sur l'icône **Retirer cette langue**.

Résultat : le message « Langue retiree » s'affiche.
:::
:::tab{label="API"}
```bash
curl -X DELETE "https://api.wakastart.app/api/app-languages/app/6a1e0c2b-0000-4000-8000-0000000000aa/language/9b2d4e6f-0000-4000-8000-000000000003" \
  -H "Authorization: Bearer $ACCESS_TOKEN"
```

Réponse attendue : `204 No Content`.
:::
::::

:::warning
Retirer une langue supprime ses fichiers de traduction publiés : une application qui les charge encore reçoit une erreur. Retirez d'abord la langue de votre interface.
:::

Deux retraits sont refusés :

- une langue obligatoire : « La langue Français (fr) est obligatoire et ne peut pas être supprimée » ;
- la langue par défaut : désignez d'abord une autre langue par défaut.

## Vérifier le résultat

`GET /api/apps/{appWid}/runtime-config` liste les langues de l'application ; la langue par défaut porte `"isDefault": true`.

## Voir aussi

- [Choisir la langue par défaut d'un réseau ou d'un client](/v1.0/langues-et-traductions/choisir-la-langue-par-defaut)
- [Référence API : contenus de l'application](/v1.0/reference-api/contenus-application)
