Aller au contenu

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.

GuideAdministrateurDéveloppeur
Accès requis
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
Durée
5 min
Voir en Markdown

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

  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.

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" }'
TypeScript
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

  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.

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

  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.

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.

Attention

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