*

Manejo de errores por punto final

Errores de autenticación (401)

La causa más común es una firma caducada. Implemente la lógica de actualización automática (consulte Autenticación y firmas API) y vuelva a intentar la solicitud fallida con la nueva firma.

async function apiCall(method, endpoint, data, correlationId) {  let signature = await signatureManager.getSignature();
try {    return await makeRequest(method, endpoint, data, signature, correlationId);  } catch (error) {    if (error.status === 401) {      // Signature may have expired — force refresh and retry once      signature = await signatureManager.forceRefresh();      return await makeRequest(method, endpoint, data, signature, correlationId);    }    throw error;  }}

Errores de búsqueda (sin resultados)

Una búsqueda de hotel puede arrojar cero resultados sin un estado de error. Esto no es una falla de API; significa que ninguna propiedad coincide con sus criterios. Maneje esto por:

• Sugerir ubicaciones cercanas o rangos de fechas más amplios.
• Filtros relajantes (por ejemplo, eliminar calificación de estrellas o restricciones de precio).
• Mostrar un mensaje amigable de "no hay resultados".

Errores de disponibilidad

Las habitaciones pueden dejar de estar disponibles entre la búsqueda y la verificación de disponibilidad. Si la respuesta de disponibilidad devuelve una matriz vacía:

• Informar al usuario que la habitación ya no está disponible.
• Sugerir volver a buscar o consultar un hotel diferente.

Errores de precios

Si la confirmación del precio falla o el token no es válido:

• Vuelva a ejecutar la verificación de disponibilidad para obtener un token de disponibilidad nuevo.
• Confirma el precio nuevamente para obtener un nuevo token de precio.
• Avisar al huésped si el precio ha cambiado.

Errores de reserva

Los errores en las reservas pueden ocurrir debido a tokens de precios vencidos, habitaciones agotadas o datos de huéspedes no válidos. Siempre:- Validar la información del huésped en el lado del cliente antes de enviarla.

• Verifique la frescura del token de precios (período de 10 minutos) antes de reservar.
• Mostrar un mensaje de error claro y ofrecer la opción de volver a intentarlo.

Límites de tarifas

La API de Xeni Hotels impone límites de tarifas para garantizar un uso justo y la estabilidad del sistema.

Encabezados de límite de tasa

La información del límite de tasa se incluye en los encabezados de respuesta:

Manejo de 429 Respuestas

Cuando recibe una respuesta 429:

1. Deja de hacer solicitudes inmediatamente.
2. Espere hasta que se restablezca la ventana de límite de velocidad (verifique el encabezado RateLimit-Reset).
3. Reanudar con patrones de solicitud normales.

*

Recomendaciones de almacenamiento en caché

El almacenamiento en caché inteligente reduce las llamadas API, mejora los tiempos de respuesta y se mantiene dentro de los límites de velocidad. A continuación se muestran las duraciones de caché recomendadas por tipo de datos:

Estrategia de clave de caché

Genere claves de caché únicas a partir de los parámetros de solicitud. Un enfoque común:

// JavaScriptimport crypto from 'crypto';
function generateCacheKey(prefix, params) {  const hash = crypto.createHash('md5')    .update(JSON.stringify(params))    .digest('hex');  return cache:${prefix}:${hash};}
// Examples:generateCacheKey('location', { query: 'miami' });// → "cache:location:3f8c9a2b..."
generateCacheKey('search', { lat: 25.76, long: -80.19, checkIn: '2025-06-01', checkOut: '2025-06-05' });// → "cache:search:7d2e1f4a..."

*

Configuración de tiempo de espera

Establezca tiempos de espera de solicitud adecuados para cada llamada API. Nuestras recomendaciones:

La búsqueda de hoteles y las comprobaciones de disponibilidad pueden tardar más porque consultan a varios proveedores en tiempo real.

*

Estrategia de reintento

No todos los errores son permanentes. Utilice una estrategia de reintento con retroceso exponencial para fallas transitorias:

Ejemplo: Reintentar con retroceso exponencial

async function apiCallWithRetry(fn, maxRetries = 3) {  for (let attempt = 0; attempt <= maxRetries; attempt++) {    try {      return await fn();    } catch (error) {      const status = error.response?.status;
// Don't retry client errors (except 401 and 429)      if (status && status >= 400 && status < 500 && status !== 401 && status !== 429) {        throw error;      }
if (attempt === maxRetries) throw error;
const delay = Math.pow(2, attempt) * 1000; // 1s, 2s, 4s      await new Promise(resolve => setTimeout(resolve, delay));    }  }}

*

Lista de verificación de preparación para la producción

Antes de publicarla, verifique que su integración cumpla con estos criterios:

*

Obtener ayuda

Si encuentra problemas que no se resuelven con esta documentación:

• Compruebe el mensaje de error: La API devuelve mensajes de error descriptivos que normalmente apuntan a la causa raíz.
• Verifique primero en UAT: Pruebe su solicitud en el entorno UAT para aislar el problema.
• Comuníquese con soporte: Comuníquese con su representante de cuenta Xeni con los siguientes detalles: