Você pode criar seu próprio site externo para gerenciar reservas de hóspedes e integrá-lo ao Motor de Reservas da Guesty por meio de uma conexão de API. A integração da API permite que você obtenha dados do Motor de Reservas, como verificar a disponibilidade do seu anúncio e criar reservas. Consulte nossa documentação completa da API do Motor de Reservas.
Você pode ter um número ilimitado de mecanismos de Reserva e até cinco instâncias da API do Motor de Reservas. Para um ambiente de teste (sandbox), você só pode criar uma instância da API do Motor de Reservas.
Para configurar uma integração de API com o Motor de Reservas Guesty, comece criando uma instância da API do Motor de Reservas.
Criar uma instância da API
Siga as instruções abaixo.
Passo a passo:
- Faça login na sua conta Guesty.
- No menu de navegação lateral, clique em
Marketing e vendas para abrir o menu suspenso. - Em Gestão de Canal, selecione Distribuição.
- Clique no cartão da API do Motor de Reservas Guesty.
- No canto superior direito, clique em Criar uma nova chave de API.
- Insira um apelido para a instância e selecione Solicitações de reserva, Reservas instantâneas ou Ambos. Em seguida, clique em Próximo.
- Clique em Selecionar propriedades para escolher as propriedades que deseja incluir no Motor de Reservas e, em seguida, clique em Próximo.
- Clique em Salvar nova chave de API.
- Na janela pop-up, clique no ícone
e copie as "Credenciais de Segredo do Cliente" e as "Credenciais de ID do Cliente" e compartilhe-as com seu desenvolvedor.
O "Segredo do Cliente" e o "ID do Cliente" permitem que desenvolvedores externos acessem o conteúdo selecionado na API específica do Motor de Reservas. Compartilhe essas chaves apenas com parceiros confiáveis.
Editar uma instância de API
Passo a passo:
- Faça login na sua conta Guesty.
- No menu de navegação lateral, clique em Marketing e vendas, para abrir o menu suspenso.
- Em Gestão de Canal, selecione Distribuição.
- Clique no cartão API do Motor de Reservas do Guesty.
- À direita da instância correspondente, clique
. Em seguida, selecione Editar chave de API. - Edite os campos correspondentes.
- Clique em Salvar.
Perguntas frequentes
Você pode criar um ambiente de teste para a API do Motor de Reservas e configurá-lo para nós?
Uma conta de teste é um recurso adicional pago que pode estar disponível. Entre em contato com seu gerenciador de contas para verificar se essa opção é adequada para você. A conta de teste é separada da sua conta existente e os dados não são copiados da conta existente para a conta de teste. Você precisará configurá-la e testá-la para seus cenários de teste específicos.
É possível redefinir os limites de tokens de acesso à API do nosso Motor de Reservas?
A Guesty não redefine os limites de tokens. Para garantir o bom funcionamento, armazene seu token em cache e monitore os cabeçalhos de resposta para acompanhar as datas de expiração e o tempo restante até a expiração. Se você tiver um slot de API do Motor de Reservas disponível, crie um novo par de chaves de API e configure-o adequadamente. Você pode usá-lo como backup até que os limites da sua chave principal sejam redefinidos.
Tokens de acesso expirados são diferentes de limites de tokens. Uma vez que um token expira, ele não pode ser reativado. Informações mais detalhadas e úteis estão disponíveis em nosso portal de desenvolvedores. Comece com os seguintes artigos: