Documentación de la API de Búsqueda de Alojamientos de Basset

La API de Búsqueda de Alojamientos de Basset te permite buscar alojamientos en función de diversos criterios como región, distribución, tipo de tarifa, fechas de check-in y check-out, moneda, idioma y más. Puedes utilizar esta API para obtener información sobre alojamientos disponibles que cumplan con los parámetros especificados. A continuación, se presenta una guía paso a paso para utilizar esta API con el comando curl.

URL de la API

https://api.basset.ws/accommodations/search

Parámetros de la URL

• region_id: El ID de la región en la que deseas buscar alojamientos. En este caso, el ID de la región es “178242”.
• region_type: El tipo de región en la que deseas buscar alojamientos. Las opciones disponibles son multi_city_vicinity, city y neighborhood.
• distribution: La distribución de alojamientos que deseas buscar. En este caso, la distribución es “2”.
• rate_type: El tipo de tarifa de alojamiento que deseas buscar. En este caso, el tipo de tarifa es “STANDALONE”.

NOTA: Corresponde al tipo de tarifa, si no se indica toma por defecto STANDALONE

Los posibles valores son:

• rate_type=STANDALONE (tarifa estándar por defecto con todos los proveedores)
• rate_type=PACKAGE_OPAQUE (se usa cuando tienen por contrato tarifas para empaquetar)
• rate_type=MOD (la habilitan algunos proveedores para usar solo si estás logueado en la plataforma)
• rate_type=DEAL (es igual que MOD dependiendo de que proveedor se trate)

• order_by: El criterio por el cual deseas ordenar los resultados de la búsqueda. En este caso, se ordena por “rank”.

NOTA: Si no se indica en la URL ordena por defecto los hoteles recomendados por el proveedor, es decir, order_by=rank

Los posibles valores son:

• order_by=price_asc (menor a mayor en precio)
• order_by=price_desc (mayor a menor en precio)
• order_by=rating (mejor puntuación)
• order_by=rank (recomendados por el proveedor)

• offset: El desplazamiento de resultados para paginación. En este caso, el desplazamiento es “0”.
• limit: El número máximo de resultados que deseas obtener. En este caso, el límite es “20”.
• currency: La moneda en la que deseas ver los precios de los alojamientos. En este caso, la moneda es “ARS” (pesos argentinos).
• language: El idioma en el que deseas recibir la información sobre los alojamientos. En este caso, el idioma es “es” para español.
• site: El sitio o país para el que deseas obtener información sobre los alojamientos. En este caso, el sitio es “AR” para Argentina.
• channel: El canal a través del cual estás accediendo a la API. En este caso, es “API”.
• checkout: La fecha de check-out en el formato “YYYY-MM-DD”. En este caso, la fecha de check-out es “2023-10-30”.
• checkin: La fecha de check-in en el formato “YYYY-MM-DD”. En este caso, la fecha de check-in es “2023-10-01”.

Encabezados de la solicitud

• x-api-key: Debes proporcionar tu clave de API en este encabezado.
• x-client-id: Debes proporcionar tu ID de cliente en este encabezado.

Método de solicitud

El método de solicitud es GET.

Ejemplo de solicitud utilizando cURL

curl --location --request GET 'https://api.basset.ws/accommodations/search?region_id=178242&region_type=multi_city_vicinity&distribution=2&rate_type=STANDALONE&order_by=rank&offset=0&limit=20&currency=ARS&language=es&site=AR&channel=API&checkout=2023-10-30&checkin=2023-10-01' \
--header 'x-api-key: API-KEY' \
--header 'x-client-id: CLIENT-ID'

Asegúrate de reemplazar API-KEY y CLIENT-ID con tus propias claves de API e ID de cliente proporcionadas por Basset.

Respuesta

La respuesta de la API contendrá información sobre los alojamientos disponibles que cumplen con los criterios de búsqueda especificados. Esta información estará en formato JSON, y podrás analizarla para obtener detalles sobre los alojamientos, como nombres, precios, ubicaciones, etc.

Recuerda consultar la documentación oficial de Basset para obtener más detalles sobre los parámetros admitidos y la estructura de la respuesta.