Informações adicionais

Informações úteis para tirar o máximo proveito da API de Merchandising.

1. Paginação: A API de Merchandising segue a mesma experiência de paginação que o restante de Rapid API. Leia mais sobre paginação.
2. Idioma: Forneça o idioma desejado para a resposta como um subconjunto do formato BCP47 que usa apenas pares de códigos de idioma e país two-digit separados por hífen. Use apenas códigos de idioma no formato ISO 639-1 alpha-2 e de país, ISO 3166-1 alpha-2. Atualmente, é utilizado apenas para gerar links para outras APIs.
3. Link da API de conteúdo propriedade: Os parceiros receberão um link tokenizado para a API de conteúdo Rapid propriedade existente para obter detalhes de propriedade, como nome, endereço, comodidades, etc.
4. É importante lembrar que a disponibilidade e os preços dos planos tarifários na API de compras da Rapid estão em constante mudança. Portanto, você sempre verá as melhores tarifas disponíveis na resposta da API de Compras (com base nos parâmetros de solicitação de ocupação e data de estadia). Isso significa, às vezes, que você obterá um desconto melhor ou um preço mais baixo por meio da API de Compras do que o que você vê na resposta da API de Promoções.
5. Não iremos devolver os códigos member-only ou ofertas para dispositivos móveis se você não for elegível para acessar esses tipos de tarifa. Para mais detalhes, entre em contato com seu Gerente de Contas.
6. Valores máximos e mínimos de desconto:
   • O campo max_discount indica o percentual máximo de desconto disponível na campanha. Por exemplo, se o maior desconto oferecido por um propriedade nessa campanha for de 60%, o valor max_discount na resposta da API seria 60%.
   • O campo min_discount indica o percentual mínimo de desconto disponível na campanha. Por exemplo, se o menor desconto oferecido por um propriedade nessa campanha for de 4%, o campo min_discount seria 4%.
7. Períodos de reserva e datas de estadia:
   • Os endpoints de conteúdo e promoções da campanha fornecerão respostas que se enquadram totalmente nos períodos de reserva e viagem solicitados (e datas de término).
   • Você pode usar os parâmetros bookable e bookable_end como filtros, usando a lógica de maior que e menor que. Isso significa que, se você solicitar ofertas com uma data de bookable de 1º de abril e uma data de bookable_end de 30 de abril, você receberá apenas ofertas que correspondam exatamente a esses critérios. Se uma oferta tiver um bookable e bookable_end entre 15 de abril e 15 de maio, respectivamente, você não receberá essa oferta. A mesma lógica se aplica às datas de estadia.
   • Se você quiser mostrar aos viajantes "apenas XX dias restantes" para uma campanha, você pode calcular esse número usando as datas bookable e bookable_end do conteúdo da campanha.