# Résoudre les problèmes de langues

> Langue refusée ou impossible à retirer, droit languages.read manquant, textes vides ou pas encore à jour dans l'application.

Cette page couvre les erreurs rencontrées en gérant les langues de l'application et en chargeant ses traductions.

## Symptômes

- [« Le code langue doit contenir 2 ou 3 lettres »](#code-langue-refusé)
- [« Cette langue est deja activee pour cette application »](#langue-déjà-activée)
- [« La langue … est obligatoire et ne peut pas être supprimée »](#langue-obligatoire)
- [« Impossible de supprimer la langue par defaut »](#langue-par-défaut)
- [« Droit applicatif requis : languages.read »](#droit-languagesread-manquant)
- [Des textes s'affichent vides](#textes-vides)
- [Un texte modifié n'apparaît pas](#texte-pas-à-jour)

## Code langue refusé

**Cause** : le champ **Code ISO** attend des lettres minuscules uniquement.

**Solution** : saisissez le code ISO 639-1 à deux lettres, par exemple `pt` pour le portugais.

## Langue déjà activée

**Cause** : l'application propose déjà cette langue. Par l'API, le message est « This language is already added to the app ».

**Solution** : aucune action n'est nécessaire.

## Langue obligatoire

**Cause** : le français et l'anglais font partie de toutes les applications. Le message est, par exemple, « La langue Français (fr) est obligatoire et ne peut pas être supprimée ».

**Solution** : gardez ces deux langues ; vous pouvez en revanche désigner une autre langue par défaut.

## Langue par défaut

**Cause** : la langue que vous retirez est la langue par défaut de l'application. Le message complet est « Impossible de supprimer la langue par defaut. Definissez d'abord une autre langue comme defaut. »

**Solution** : cliquez sur **Definir comme langue par defaut** sur une autre langue, puis retirez la première.

## Droit languages.read manquant

**Cause** : la clé API ou le jeton utilisé pour `GET /api/languages/code/{code}/file` ne porte pas le droit `languages.read`. La réponse est un `403`.

**Solution** : utilisez une clé API de l'application dont le profil porte ce droit, depuis votre serveur.

## Textes vides

**Cause** : la clé n'a pas encore de valeur dans cette langue. Elle figure dans le fichier avec une chaîne vide.

**Solution** : traitez une chaîne vide comme manquante et repliez-vous sur la langue par défaut (`returnEmptyString: false` avec i18next). Le texte apparaîtra dans le fichier dès que sa traduction sera saisie.

## Texte pas à jour

**Cause** : les fichiers de traduction sont mis en cache pendant une heure, par le stockage comme par votre propre route si elle les relaie.

**Solution** : attendez l'expiration du cache, ou rechargez sans cache pour vérifier. L'adresse du fichier, elle, ne change pas.

## Toujours bloqué ?

Rassemblez le WID de l'application, le code de la langue, le type de fichier et le message exact, puis contactez le support Wakastart.
