Skip to main content

Página de resultado de pesquisa de quarto

Este guia é voltado para empresas que desejam integrar seus sites com nossa plataforma de reservas, redirecionando os usuários para uma página de resultados de busca de quarto.

URL padrão​

A URL abaixo direciona para página de resultado de pesquisa de quarto:

https://reservas.meuexemplo.com.br/hotels/HOTEL_OMNI_{hotelId}/rooms/{roomId}

URL com query strings obrigatórios​

https://reservas.meuexemplo.com.br/hotels/HOTEL_OMNI_{hotelId}/rooms/{roomId}?startDate=2025-07-28&endDate=2025-07-30

URL com quartos (ocupações)​

  • Utilize o parâmetro rooms[] para cada configuração.
    • a: adulto
    • c: criança

Observação: caso não seja passado o rooms, consideramos 1 adulto e 0 criança.

URL com um quarto e um adulto​

  • rooms[]=a1
https://reservas.meuexemplo.com.br/hotels/HOTEL_OMNI_{hotelId}/rooms/{roomId}?endDate=2025-07-16&rooms[]=a1&startDate=2025-07-14

URL com um quarto, dois adultos e uma criança de dois anos​

  • rooms[]=a2c2
https://reservas.meuexemplo.com.br/hotels/HOTEL_OMNI_{hotelId}/rooms/{roomId}?endDate=2025-07-16&rooms[]=a2c2&startDate=2025-07-14

URL com um quarto, dois adultos e duas crianças de dois e cinco anos.​

  • No caso de múltiplas crianças, use vírgula para separar as idades, por exemplo: a2c2,5 (2 adultos, 2 crianças de 2 e 5 anos).
  • rooms[]=a2c2%2C5
https://reservas.meuexemplo.com.br/hotels/HOTEL_OMNI_{hotelId}/rooms/{roomId}?endDate=2025-07-16&rooms[]=a2c2%2C5&startDate=2025-07-14

URL com múltiplos quartos​

  • Utilize o parâmetro rooms[] para cada configuração.
  1. Quarto com 2 adultos e 1 criança de 2 anos.
  2. Quarto com 3 adultos e 2 crianças de 5 e 7 anos.

Observação: não se limita a 2 quartos.

https://reservas.meuexemplo.com.br/hotels/HOTEL_OMNI_{hotelId}/rooms/{roomId}?endDate=2025-07-16&rooms[]=a2c2&rooms[]=a3c5%2C7&startDate=2025-07-14

URL com filtro de tarifas​

  • Utilize o parâmetro roomRateIds[] para cada tarifa que deseja filtrar.
  • Você pode filtrar por múltiplas tarifas simultaneamente.

URL com uma tarifa específica​

https://reservas.meuexemplo.com.br/hotels/HOTEL_OMNI_{hotelId}/rooms/{roomId}?endDate=2025-07-16&startDate=2025-07-14&roomRateIds[]=xxxx

URL com múltiplas tarifas​

https://reservas.meuexemplo.com.br/hotels/HOTEL_OMNI_{hotelId}/rooms/{roomId}?endDate=2025-07-16&startDate=2025-07-14&roomRateIds[]=xxxx&roomRateIds[]=yyyy

Observação: Ao utilizar o filtro de tarifas, apenas as tarifas especificadas serão exibidas para o quarto selecionado.

Parâmetros query string:​

NomeDescriçãoTipoObrigatório
startDateData de check-in no formato YYYY-MM-DD
Se não informado, o sistema define a data atual como valor padrão.		TextoNão
endDateData de check-out no formato YYYY-MM-DD
Se não informado, o sistema define como valor padrão a data atual acrescida do número mínimo de noites configurado para o otabuilder acessado.		TextoNão
promoCodeCódigo promocional a ser aplicadoTextoNão
rooms[]Lista de configurações de quartos (acomodações) (ex: a2c5 = 2 adultos, criança de 5 anos)Array de textosNão
roomRateIds[]Lista de IDs de tarifas de quarto a serem aplicadas (ex: roomRateIds[]=xxxx)Array de textosNão