Référence APIDéfinir ma langue préférée
POST/v1/me/language

Définir ma langue préférée

Persiste la langue préférée de l'utilisateur connecté pour les communications, notamment les emails.

1 min de lectureTélécharger en PDF

Requête exemple

{
"language": "fr"
}

Réponse exemple

{
"ok": true,
"language": "fr"
}

Enregistre la langue préférée de l'utilisateur actuellement authentifié dans son profil (coffrify_profiles.language). Cette valeur sert de référence pour les communications transactionnelles, en particulier l'envoi des emails dans la langue de l'utilisateur. Le point d'entrée n'altère pas le cookie de locale qui pilote l'affichage de l'interface : il met uniquement à jour la préférence persistée côté serveur. La langue fournie doit faire partie des cinq langues prises en charge : fr, en, de, es et it.

Authentification

Requiert une session utilisateur valide. L'identité est résolue côté serveur via la session Supabase (cookies), sans scope spécifique : il s'agit d'une route orientée utilisateur connecté et non d'une route à scopes. Si aucun utilisateur n'est authentifié, la requête est rejetée avec un statut 401.

Corps de la requête

Le corps doit être un objet JSON. Un corps invalide ou non parsable est traité comme un objet vide, ce qui aboutit à une erreur de validation sur le champ language.

ChampTypeRequisDescription
languagestringOuiCode de langue cible. Valeurs acceptées : fr, en, de, es, it. Toute autre valeur (ou absence) renvoie une erreur 400.

Réponse

En cas de succès, la réponse renvoie ok à true ainsi que la langue effectivement enregistrée dans le champ language. La mise à jour est appliquée à la ligne de profil correspondant à l'identifiant de l'utilisateur authentifié.

ChampTypeDescription
okbooleanIndique que la préférence a été persistée avec succès.
languagestringLa langue enregistrée, identique à la valeur fournie dans la requête.

Erreurs

CodeQuandRésolution
401Aucun utilisateur authentifié ({ "error": "unauthorized" }).Authentifiez l'utilisateur et renvoyez la requête avec une session valide.
400Le champ language est absent ou hors de la liste supportée ({ "error": "unsupported language" }).Fournissez une langue parmi fr, en, de, es, it.
500Échec de la mise à jour en base ({ "error": "<message>" }).Réessayez ; si l'erreur persiste, contactez le support.

Voir aussi

GET/v1/meRécupère le profil de l'utilisateur authentifié, y compris sa langue préférée.
PATCH/v1/meMet à jour les autres attributs du profil de l'utilisateur connecté.