Localisation du contenu API

Localiser les réponses API et le contenu dynamique des produits

Offrez aux clients frontaux la langue qu'ils demandent sans dupliquer votre API, déplacer vos enregistrements ni masquer la logique de traduction dans une surcouche du navigateur.

Une requête API prenant en compte les paramètres régionaux
Requête API + paramètres régionaux
Champs traduits
Interface utilisateur localisée

Conservez les autorisations et la propriété des données côté serveur tout en renvoyant le contenu dans la langue requise par chaque client ou route.

La réponse courte

La localisation de l'API intervient au moment de l'assemblage des données produit. Votre serveur peut résoudre les champs traduits pour la langue demandée, conserver la valeur source par défaut et renvoyer une réponse que les clients localisés peuvent afficher directement.

/ 01

Choisissez les champs traduisibles

Indiquez les noms de produits, les descriptions, les étiquettes ou les valeurs éditoriales que les utilisateurs de l'API doivent recevoir dans une autre langue.

/ 02

Transmettez la locale active

Transmettez le langage tout au long de la requête ou du contexte de l'application afin que le serveur dorsal sache quelle version résoudre.

/ 03

Résoudre avec une solution de repli

Recherchez la valeur traduite et conservez le champ de langue source lorsqu'une traduction n'est pas encore prête.

/ 04

Répondre

Renvoyer une forme de réponse stable aux clients web, mobiles ou partenaires sans que chaque client ait à implémenter une logique de traduction.

Pourquoi c'est important

Un flux de travail de localisation qui a sa place au sein de votre produit.

Comportement axé sur l'API

Traduisez les valeurs là où les objets de réponse sont assemblés au lieu de demander à chaque interface d'interpréter le contenu source brut.

Vos archives restent fiables.

Conservez les modèles, les permissions, les relations et les valeurs sources dans le système backend qui les possède déjà.

Un contrat local

Diffusez le même contenu adapté à la langue sur une page Next.js, une application mobile, un outil interne ou un consommateur d'API externe.

Les identifiants restent côté serveur.

Protégez les secrets du projet et décidez précisément quels champs localisés sont exposés par chaque point de terminaison.

/ Foire aux questions

Questions que se posent les équipes avant la localisation.

La traduction doit-elle se faire dans l'API ou dans l'interface utilisateur ?

Lorsque le serveur est propriétaire du contenu et des autorisations, la résolution des champs prenant en compte la langue dans l'API crée un contrat cohérent pour chaque client et évite que les informations d'identification ne soient transmises au client.

Que se passe-t-il si une traduction demandée est manquante ?

Renvoie la valeur source d'origine comme solution de repli prévisible, puis laisse le flux de travail de traduction identifier la valeur manquante ou obsolète pour une révision ultérieure.

La localisation d'API est-elle compatible avec une interface Next.js ?

Oui. Une application Next.js peut demander la langue active et afficher la réponse localisée dans les pages de routage, les composants serveur et la génération des métadonnées.