# General Translation React SDKs (gt-react, gt-next): Registrar configuraciones regionales de solicitud
URL: https://generaltranslation.com/es/docs/react/nextjs/registering-request-locales.mdx
---

title: Registrar configuraciones regionales de solicitud
description: Cómo registrar una configuración regional para los manejadores de solicitud de rutas de Next.js App Router y los manejadores de solicitud de imágenes de metadatos generadas con General Translation.
related:
  links:
    - /docs/react/nextjs/reference/functions/register-locale
    - /docs/react/nextjs/app-router-middleware
    - /docs/react/nextjs/reference/functions/get-locale
    - /docs/react/nextjs/reference/functions/get-gt

---

Con un segmento raíz `[locale]`, `gt-next` normalmente obtiene la configuración regional a través de `next/root-params`. Los manejadores de solicitud de rutas y los manejadores de solicitud de imágenes de metadatos generadas no pueden usar ese módulo. Lee la configuración regional desde la entrada del manejador de solicitud y luego llama a [`registerLocale`](/docs/react/nextjs/reference/functions/register-locale) antes de cualquier otra función de `gt-next/server`.

## Registra un manejador de solicitud para una ruta [#route-handlers]

En un manejador de solicitud bajo `app/[locale]`, lee la configuración regional de `params`:

```ts title="app/[locale]/api/greeting/route.ts"
import { getGT, registerLocale } from 'gt-next/server';

export async function GET(
  _request: Request,
  { params }: { params: Promise<{ locale: string }> },
) {
  const { locale } = await params;
  registerLocale(locale);

  const gt = await getGT();
  return Response.json({ greeting: gt('Welcome') });
}
```

Para un manejador de solicitud fuera de `[locale]`, obtén la configuración regional a partir de la URL de `Request`, las cabeceras, los parámetros de consulta o el cuerpo, según tu API, y luego regístrala de la misma forma.

La configuración regional registrada está disponible para [`getGT`](/docs/react/nextjs/reference/functions/get-gt), [`getLocale`](/docs/react/nextjs/reference/functions/get-locale), [`getTranslations`](/docs/react/nextjs/reference/functions/get-translations), [`getMessages`](/docs/react/nextjs/reference/functions/get-messages) y otras funciones de `gt-next/server` durante el resto de la solicitud.

## Registrar un manejador de solicitud para imágenes de metadatos [#metadata-images]

Los archivos generados de Open Graph, Twitter, icon y Apple icon también reciben los `params` de la ruta:

```tsx title="app/[locale]/opengraph-image.tsx"
import { ImageResponse } from 'next/og';
import { getGT, registerLocale } from 'gt-next/server';

export default async function Image({
  params,
}: {
  params: Promise<{ locale: string }>;
}) {
  const { locale } = await params;
  registerLocale(locale);

  const gt = await getGT();
  return new ImageResponse(<div>{gt('Welcome')}</div>);
}
```

Usa el mismo patrón en `twitter-image.tsx`, `icon.tsx` y `apple-icon.tsx`.

## Maneja otros puntos de entrada [#other-entry-points]

`generateMetadata` recibe parámetros dinámicos de ruta desde el directorio raíz hasta su segmento actual, por lo que no tiene la misma limitación que un manejador de solicitud de imágenes de metadatos.

Los archivos `sitemap.ts`, `robots.ts` y `manifest.ts` generados no reciben parámetros de ruta ni un objeto de solicitud. Elige la configuración regional explícitamente en tu lógica de generación y luego regístrala antes de llamar a una función de `gt-next/server`.

El registro se aplica por solicitud. Llama a `registerLocale` una sola vez, después de resolver la configuración regional y antes de cualquier otra función de servidor de General Translation.
## Next steps

- /docs/react/nextjs/reference/functions/register-locale
- /docs/react/nextjs/app-router-middleware
- /docs/react/nextjs/reference/functions/get-locale
- /docs/react/nextjs/reference/functions/get-gt