localização de conteúdo da API

Localize as respostas da API e o conteúdo dinâmico do produto.

Ofereça aos clientes front-end o idioma que solicitam sem duplicar a sua API, mover os seus registos ou ocultar a lógica de tradução numa sobreposição do browser.

Um pedido de API que tem em consideração a localização.
Pedido de API + localidade
Campos traduzidos
Front-end localizado

Mantenha as permissões e a propriedade dos dados no backend, enquanto devolve o conteúdo no idioma requerido por cada cliente ou rota.

Resposta curta

A localização da API funciona no ponto em que os dados do produto são reunidos. O seu backend pode resolver os campos traduzidos para a localidade solicitada, preservar o valor original como alternativa e devolver uma resposta que os clientes localizados possam renderizar diretamente.

/ 01

Selecione os campos traduzíveis

Indique os nomes dos produtos, descrições, etiquetas ou valores editoriais que os consumidores da API devem receber noutra língua.

/ 02

Indique a localidade ativa.

Transmita o idioma através do pedido ou do contexto da aplicação para que o servidor saiba qual a versão a resolver.

/ 03

Resolva com uma alternativa.

Consulte o valor traduzido e mantenha o campo do idioma de origem quando a tradução ainda não estiver pronta.

/ 04

Sirva a resposta

Retorna um formato de resposta estável para clientes web, móveis ou parceiros, sem exigir que cada cliente implemente a lógica de tradução.

Por que razão isso importa

Um fluxo de trabalho de localização que deve estar integrado no seu produto.

Comportamento API-first

Traduzir os valores onde os objetos de resposta são montados, em vez de pedir a cada front-end que interprete o conteúdo bruto da fonte.

Os seus registos permanecem válidos.

Mantenha os modelos, permissões, relações e valores de origem no backend que já os possui.

Contrato de localidade única

Forneça o mesmo conteúdo adaptado ao idioma para uma página Next.js, aplicação móvel, ferramenta interna ou consumidor de API externa.

As credenciais permanecem no servidor.

Proteja os segredos do projeto e decida exatamente quais os campos localizados que serão expostos por cada ponto final.

Perguntas frequentes

Perguntas que as equipas fazem antes da localização.

A tradução deve ocorrer na API ou no frontend?

Quando o backend detém o conteúdo e as permissões, a resolução de campos com reconhecimento de idioma na API cria um contrato consistente para cada cliente e mantém as credenciais fora do alcance do cliente.

O que acontece se faltar uma tradução solicitada?

Devolver o valor original da fonte como uma alternativa previsível e, em seguida, deixar que o fluxo de trabalho de tradução identifique o valor em falta ou desatualizado para revisão posterior.

É possível fazer localização de API com um frontend Next.js?

Sim. Uma aplicação Next.js pode solicitar a localidade ativa e renderizar a resposta localizada dentro das páginas de rotas, componentes do servidor e geração de metadados.