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.
- Required access
- Accès au paramétrage de l'application (Administrateur d'applications, Propriétaire ou droit apps.read) et droit languages.manage. Le Propriétaire dispose de tous les droits
- Duration
- 5 min
This page has not been translated yet and is shown in French.
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 :
espour l'espagnol,depour l'allemand,itpour l'italien.
Ajouter une langue
- Dans la barre latérale, ouvrez Mes Apps, choisissez votre application, puis Paramétrage.
- Ouvrez l'onglet Langues. La carte Langues supportées liste les langues actuelles.
- Cliquez sur Ajouter une langue.
- Saisissez le Nom de la langue, par exemple
Español, puis le Code ISO, par exemplees. 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). - Cliquez sur Ajouter.
Résultat : le message « Langue "Español" ajoutee » s'affiche et la langue rejoint la liste.
Retrouvez la langue dans le référentiel, ou créez-la, puis rattachez-la à l'application.
# 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" }'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 :
{ "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
- 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.
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
- 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.
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.