This is an auto-generated translation

Conteúdo

As APIs de conteúdo rápido fornecem acesso ao conteúdo de todas as propriedades do Rapid API.

Propriedade API de conteúdo

Retorna uma lista de IDs de propriedades ou o conteúdo completo da propriedade para as propriedades ativas no idioma solicitado.

Use esta API para recuperar os IDs de propriedade ou o conteúdo completo da propriedade com base nos seus critérios de busca. Por exemplo, recupere uma lista com as propriedades que foram adicionadas desde a última segunda-feira ou recupere o conteúdo da propriedade de uma lista específica de IDs de propriedades.

APIs de arquivo de conteúdo

Uma das funções disponíveis em Rapid API é a capacidade de exportar uma lista das propriedades ativas e seus detalhes. Há duas APIs de arquivo para escolher.

Warning

Observação

As APIs de arquivo de conteúdo têm suporte limitado para estoque global expandido, por isso recomendamos que você use a API de conteúdo.

Saiba mais sobre o estoque global expandido

Arquivo de catálogo de propriedades

Esta API retorna um link para baixar a lista principal de propriedades ativas no idioma solicitado. A resposta inclui informações de alto nível sobre cada propriedade. Use este arquivo para ver a lista completa de propriedades. Os detalhes da propriedade são úteis ao mapear as listas de propriedades de outros fornecedores.

Arquivo de conteúdo de propriedades

Esta API retorna um link para baixar todo o conteúdo de todas as propriedades ativas no idioma solicitado. A resposta inclui informações sobre a propriedade, o quarto e a tarifa. Use este arquivo para recuperar todo o conteúdo de todas as propriedades. Se você precisar apenas de um subconjunto de propriedades, use a API de conteúdo de propriedades.

Propriedades inativas

Às vezes, propriedades que antes podiam ser reservadas fecham e se tornam inativas em nosso inventário. A API inativa propriedade pode ser usada para solicitar uma lista de todas as propriedades que estão inativas desde uma determinada data, permitindo que você atualize seu cache ou armazenamento de conteúdo para excluir propriedades que não podem ser vendidas/reservadas dentro de Rapid API.

No exemplo abaixo, o parceiro tentou atualizar o armazenamento ou cache de conteúdo usando a API de conteúdo da propriedade ou a API de arquivo de conteúdo da propriedade pela última vez em 31 de maio. Isso mostrará uma lista não ordenada de objetos com property_idque devem ser removidos do sistema. Esse ponto de extremidade pode ser usado em conjunto com um ou mais dos seguintes parâmetros no ponto de extremidade da API de conteúdo da propriedade para seguir acrescentando atualizações ao seu armazenamento ou cache de conteúdo: date_added_start, date_added_end, date_updated_start ou date_updated_end.

Exemplo:

Solicitação:

https://test.ean.com/v3/properties/inactive?since=2023-06-01

Resposta:

[
  {
    "property_id": "10003243"
  },
  {
    "property_id": "10012775"
  },
  {
    "property_id": "10013765"
  },
  {
    "property_id": "10017071"
  },
  {
    "property_id": "10041102"
  },
  {
    "property_id": "10042"
  },
  {
    "property_id": "10074774"
  },
  {
    "property_id": "10089905"
  },
  {
    "property_id": "10091055"
  },
  {
    "property_id": "10268276"
  },
  {
    "property_id": "1029882"
  },
  {
    "property_id": "103115"
  },
  {
    "property_id": "10349744"
  },
  {
    "property_id": "10373667"
  },
  {
    "property_id": "1037667"
  },
  {
    "property_id": "1039715"
  },
  {
    "property_id": "10401509"
  },
  {
    "property_id": "104201"
  },
  {
    "property_id": "10465614"
  },
  {
    "property_id": "10484434"
  },
  {
    "property_id": "10488054"
  },
  {
    "property_id": "10520425"
  }
]

Referência de cadeia

Este parâmetro retorna uma coleção completa de cadeias reconhecidas por Rapid API. As redes representam uma empresa principal que pode ter várias marcas associadas a ela.

Uma marca só pode ser associada a uma rede. Por exemplo, Hilton Worldwide é uma rede de hotéis que tem várias marcas associadas, incluindo DoubleTree, Hampton Inn e Embassy Suites.

Tarefas de limpeza de aluguel de férias na Califórnia

Uma nova lei da Califórnia exige que propriedades de aluguel por temporada divulguem tarefas de limpeza obrigatórias para viajantes. Fizemos uma alteração em nossa API para permitir que você exiba as tarefas de limpeza. Cada parceiro que usa Rapid API é responsável por garantir que a maneira como as tarefas de limpeza são exibidas esteja em conformidade com a lei.

Qual é a mudança?

Melhoramos o Rapid API para incluir um novo campo de instruções no objeto checkoutcontendo instruções de check-out fornecidas pelo gerente de aluguel de férias.

Exemplo:

"checkout": {
"instructions": "<ul>  <li>The host requests you complete the following cleaning tasks before checking out:</li><li>Start the dishwasher</li><li>Strip any used beds and gather used towels</li><li>Remove personal items</li><li>Turn off the lights</li>  </ul>"
}

Mais informações de referência

Localização

O parâmetro languageusa apenas pares hifenizados de códigos de idioma e país two-digit. Verifique os idiomas suportados antes de integrar quaisquer códigos.

Classificações por estrelas

As classificações por estrelas retornadas na Rapid API de conteúdo oferecem orientações para viajantes sobre o que podem esperar, no geral, da propriedade em termos de mobília, serviços e comodidades. Saiba mais sobre como funcionam as classificações por estrelas.

Listas de referência

As informações da propriedade disponíveis nas APIs de conteúdo para Rapid costumam ser representadas como IDs. Use as listas de referência para entender o que esses IDs significam. As listas de referência estão disponíveis apenas em inglês, mas os nomes localizados são retornados nas APIs.

Número de registro

O parâmetro registry_number na API de conteúdo para Rapid vai retornar detalhes de registro únicos ou múltiplos. Esses detalhes podem conter palavras, letras, números e caracteres especiais, conforme exigido por país. Fornecemos esses números para que você possa cumprir com os seus requisitos legais e regulamentares de exibição.

Exemplos:

"registry_number": "Property Registration Number 004071AAA-00004, IT005748GHFMUHG",
"registry_number": "IT00574-8GHFMUHG",

Oportunidades de inventário

A página oportunidades de estoque fornecerá uma lista de propriedades não mapeadas que são relevantes para sua integração com Rapid API. Como a nossa oferta de propriedades está em constante mudança, revise com frequência para fazer a adição ou o mapeamento dessas opções de hospedagem para propriedades de outros fornecedores, para que viajantes não encontrem duplicatas nem percam novas propriedades no seu site.

Detalhes da API

Explore as definições dos pontos de extremidade relacionados a conteúdo nesta página e use o API Explorer ou outro software de teste para comparar os exemplos e as definições de esquemas com o resultado real.


Recursos adicionais

Não importa se deseja testar todos os pontos de extremidade da Rapid API, ou baixar a especificação OpenAPI ou a nossa coleção Postman Collection, você pode contar conosco.



Esta página foi útil?
Como podemos melhorar esse conteúdo?
Agradecemos por nos ajudar a melhorar.