POST/v1/hotels/description

Generar descripción de hotel

Genera o recupera una descripción localizada de hotel a partir de la metadata disponible en Travelandz.

Endpoint

Método	Ruta	Auth
`POST`	`/v1/hotels/description`	API key requerida

Headers obligatorios:

Header	Descripción
`Authorization`	`Bearer <secret_key>`. El secret se muestra una sola vez al crear la credencial.
`X-Travelandz-Id`	`<public_key>:<profile_code>`. El `profile_code` es el codigo de Developer Profile con prefijo `dp_` que ves en el dashboard. Esto vincula la peticion con un perfil y una credencial.
`Content-Type`	Usa `application/json` para peticiones con cuerpo.

Parámetros de la petición

No requiere parámetros de ruta ni query.

Esquema del cuerpo de la petición

hotelId

stringSí

language

enum

eneszh

Sí

Respuesta exitosa

Devuelve localized description text and provider context.

Esquema del cuerpo de la respuesta

description

stringSí

liveMode

booleanSí

True cuando la peticion se sirve desde el entorno live de Travelandz. Este valor viene de Travelandz, no del payload del proveedor.

Ejemplo

bash

curl -X POST https://api.sandbox.travelandz.com/v1/hotels/description \
  -H "Authorization: Bearer $TRAVELANDZ_SECRET_KEY" \
  -H "X-Travelandz-Id: $TRAVELANDZ_PUBLIC_KEY:$TRAVELANDZ_PROFILE_CODE" \
  -H "Content-Type: application/json" \
  -d '<request_body_json>'