Demo ao vivo

Integração de API hoteleira

Integração da API RateHawk: da API key a reservas de hotéis ao vivo

Conecte a sua conta RateHawk ao PHPTRAVELS e venda hotéis e apartamentos da RateHawk no seu próprio site e no seu portal de agentes. O conector está pronto: adicione as suas chaves de API, importe a base de dados de hotéis, defina o seu markup e conclua a certificação da RateHawk.

  • Conector RateHawk pronto
  • ETG API v3
  • Importação do dump de hotéis
  • O seu markup sobre tarifas net

O fornecedor

O que é a RateHawk e por que as agências a conectam

A RateHawk é a plataforma de reservas B2B da Emerging Travel Group (ETG) para agentes de viagens, operadores turísticos e empresas de viagens. Os parceiros reservam hotéis, apartamentos e outras hospedagens a tarifas net, no portal próprio da RateHawk ou por meio da sua API.

A API chama-se ETG API. A versão atual é a v3, uma API REST com pedidos e respostas em JSON que cobre pesquisa, reserva e cancelamento. O PHPTRAVELS inclui um conector RateHawk no módulo de hospedagem, para que os resultados da RateHawk apareçam ao lado dos seus outros fornecedores de hotéis e dos seus próprios contratos.

Relacionado:HospedagensMotor de reservas de hotelAPIs de viagens

Ficha do fornecedor
Empresa
RateHawk, parte da Emerging Travel Group
Tipo
Plataforma B2B de hospedagem para profissionais de viagens
Inventário
Mais de 2,6 milhões de opções de hospedagem, segundo a RateHawk
Parceiros de API
Mais de 700 clientes de API, segundo a RateHawk em 2024
API
ETG API v3 · REST · JSON
No PHPTRAVELS
Conector pronto no módulo de hospedagem

O fluxo de reserva da ETG API v3

Como decorre uma reserva RateHawk, fase a fase

Todas as reservas RateHawk passam pelas mesmas cinco fases. Cada uma indica as chamadas da ETG API por trás dela e o que o PHPTRAVELS faz por você.

  1. 01

    Pesquisa

    Chamadas da ETG API

    Pesquisa por região · por coordenadas geográficas · por IDs de hotel

    PHPTRAVELS

    Pesquisa por cidade, área do mapa ou lista de hotéis, com datas, hóspedes e residência do viajante, e mostra tarifas net ao vivo com o seu markup.

  2. 02

    Página do hotel

    Chamadas da ETG API

    Retrieve hotelpage

    PHPTRAVELS

    Carrega todos os quartos e tarifas do hotel escolhido: regime, impostos, política de cancelamento e tipo de pagamento.

  3. 03

    Pré-reserva

    Chamadas da ETG API

    Prebook rate · Retrieve rate info

    PHPTRAVELS

    Verifica, logo antes do pagamento, se a tarifa escolhida continua disponível por esse preço e interrompe o checkout se ela tiver mudado.

  4. 04

    Reserva

    Chamadas da ETG API

    Criar, iniciar e verificar o processo de reserva

    PHPTRAVELS

    Cria a reserva, envia os dados dos hóspedes, acompanha o status até a confirmação e guarda o ID do pedido RateHawk.

  5. 05

    Após a reserva

    Chamadas da ETG API

    Retrieve bookings · Cancel booking · Webhooks de status

    PHPTRAVELS

    Envia o voucher, mostra a reserva no painel e na conta do cliente e processa os cancelamentos conforme a política da tarifa.

Dados estáticos

Importe a base de dados de hotéis da RateHawk uma vez e mantenha-a atualizada

Os resultados de pesquisa trazem apenas tarifas. Nomes, endereços, fotos, comodidades e descrições vêm dos dados estáticos da ETG, que o PHPTRAVELS importa para as suas páginas de hotel.

  • Dump de regiões

    Países, cidades e áreas, para que os viajantes possam pesquisar por destino.

  • Dump de hotéis

    O arquivo completo de conteúdo hoteleiro: nomes, endereços, coordenadas, fotos, comodidades e descrições.

  • Dump incremental

    Apenas o que mudou desde a última importação, para que o catálogo fique atualizado sem uma recarga completa.

  • Dump de avaliações

    Notas e textos de avaliações de hóspedes para exibir nas páginas de hotel, quando o seu contrato os inclui.

Importação de conteúdo hoteleiro
  • Dump de regiões100%
  • Dump de hotéis100%
  • Dump incremental64%
  • Dump de avaliações30%

Tela de exemplo. Os números dependem da sua conta e dos seus idiomas.

Além dos arquivos de dump, a ETG oferece uma Content API para dados de hotéis sob demanda.

API key e sandbox

Como funciona a autenticação da API RateHawk

A ETG API usa autenticação HTTP Basic. O seu key ID é o nome de usuário e a sua API key é a senha, enviados por HTTPS em cada pedido.

Um pedido de pesquisa no sandbox (exemplo)
 1# HTTP Basic: key ID = username, API key = password 2curl -u "$KEY_ID:$API_KEY" \ 3  -H "Content-Type: application/json" \ 4  https://api-sandbox.ratehawk.com/api/b2b/v3/search/serp/hotels/ \ 5  -d '{ 6    "checkin": "2026-11-14", 7    "checkout": "2026-11-16", 8    "residency": "gb", 9    "language": "en",10    "currency": "USD",11    "guests": [{ "adults": 2, "children": [] }],12    "hids": [8473727]13  }'1415# 8473727 = the test hotel: a real booking if you book it
HTTP BasicETG API v3api-sandbox.ratehawk.com → api.ratehawk.com
Dois hosts
Sandbox: api-sandbox.ratehawk.com. Testes e produção: api.ratehawk.com. Os antigos hosts worldota.net estão descontinuados.
O hotel de teste é real
As chaves de teste só podem reservar o hotel de teste com hid 8473727, e essa reserva é real, com responsabilidade financeira real. Cancele-a logo após o teste.
As chaves ficam no servidor
O PHPTRAVELS guarda o key ID e a API key na configuração do servidor, nunca no navegador nem num app.
A residência importa
As tarifas dependem da residência do viajante, por isso o conector a envia em cada pesquisa.

Configuração no PHPTRAVELS

Configure o conector RateHawk em quatro passos

Nada de código: o conector é configurado no painel de administração.

  1. 01Adicione as suas chaves de APICole o key ID e a API key da RateHawk, primeiro para o sandbox e depois para produção.
  2. 02Importe a base de dados de hotéisCarregue os dumps de regiões e de hotéis e agende as atualizações incrementais.
  3. 03Defina markup e moedaMarkups percentuais ou fixos, por canal, grupo de agentes ou destino, nas moedas em que você vende.
  4. 04Teste e entre em produçãoFaça a reserva e o cancelamento de teste, passe na certificação e mude para as chaves de produção.
Fornecedores › RateHawkRateHawk

Ambiente

https://api-sandbox.ratehawk.comhttps://api.ratehawk.com

Key ID4127
API key••••••••••••••••
Markup12% sobre tarifas net
MoedaUSD · EUR · GBP
Residência padrãoGB

Tela de configurações de exemplo.

Certificação

Do contrato ao acesso à produção

A RateHawk só libera a produção depois que o contrato é assinado e a sua integração passa na certificação.

  1. 1

    Assine o contrato de API

    Você

    Entre em contato com a RateHawk como empresa de viagens e assine o contrato de API para os seus mercados.

  2. 2

    Receba as chaves do sandbox

    RateHawk

    A RateHawk emite um key ID e uma API key para o sandbox.

  3. 3

    Conecte e importe

    PHPTRAVELS

    As chaves são inseridas no PHPTRAVELS, os dados estáticos são importados e os markups são definidos.

  4. 4

    Passe na certificação

    RateHawk

    A RateHawk verifica a integração, incluindo os fluxos de reserva, status e cancelamento.

  5. 5

    Acesso à produção

    Você

    As chaves de produção são inseridas no painel e as reservas reais começam.

Portal, API ou motor

Três formas de vender hotéis RateHawk

Os agentes já podem reservar hoje no site da própria RateHawk. A API, dentro do seu próprio motor de reservas, é o que coloca os hotéis RateHawk sob a sua marca.

  • Site da RateHawk

    Quem reserva
    Os seus agentes, uma reserva de cada vez
    De quem é a marca
    RateHawk
    O que é preciso
    Cadastrar-se como agente e fazer login

  • Desenvolvimento próprio com a API

    Quem reserva
    Os seus clientes e agentes, online
    De quem é a marca
    Sua
    O que é preciso
    Meses de desenvolvimento e certificação

  • PHPTRAVELS com RateHawk

    Quem reserva
    Os seus clientes e agentes, online
    De quem é a marca
    Sua
    O que é preciso
    Configuração, importação de conteúdo e certificação

Multifornecedor

A RateHawk ao lado dos seus outros fornecedores de hotéis

A RateHawk é um fornecedor no módulo de hospedagem. A mesma pesquisa pode incluir as suas outras APIs de hotéis e os seus próprios contratos, com markups e roteamento por fornecedor.

  • Agoda
  • Amadeus
  • Booking.com
  • Hotelbeds
  • Hotelston
  • RateHawk
  • Stuba
  • TBO Holidays
  • Travelport
  • Wanderbeds
Ver preçosExperimente a demo de hotéis

Leia o guia para agentes

Perguntas frequentes

Perguntas sobre a integração da API RateHawk

O que as agências perguntam antes de conectar a RateHawk.

Fale com vendas

A RateHawk não publica nenhuma taxa pelo acesso à API. Você assina um contrato de API e vende os hotéis dela a tarifas net com o seu próprio markup. Os seus custos são o software de reservas, a hospedagem do site e os pagamentos.

Entre em contato com a RateHawk como empresa de viagens e assine o contrato de API. A RateHawk emite então um key ID e uma API key para o sandbox, e as chaves de produção após a certificação.

A documentação da ETG API está online em docs.emergingtravel.com, com a B2B API, a Content API e os guias do sandbox e da certificação. Não há um PDF separado para baixar; a documentação online é a versão atual.

A ETG API é a API da Emerging Travel Group, a empresa por trás da RateHawk. Integração da API RateHawk e integração da ETG API são a mesma coisa; a versão atual é a v3.

O PHPTRAVELS é uma licença única a partir de US$ 2.499 com o código-fonte completo, e o conector RateHawk está incluído no módulo de hospedagem. As suas condições comerciais com a RateHawk são acordadas com a RateHawk.

Sim, em api-sandbox.ratehawk.com. Atenção: as chaves de teste só podem reservar o hotel de teste com hid 8473727, e essa reserva é real, por isso cancele-a logo após o teste.

Os agentes se cadastram e fazem login em ratehawk.com para reservar no portal. O acesso à API é separado: usa o key ID e a API key do seu contrato, não o seu login do portal.

O conector já existe, então o tempo vai para o contrato, a inserção das chaves, a importação do conteúdo hoteleiro e a certificação da RateHawk, e não para o desenvolvimento.

Sim. O mesmo conector atende o seu site B2C e o seu portal de agentes B2B, com markups separados por canal e grupo de agentes.

Cada tarifa traz a sua política de cancelamento, exibida antes do pagamento. Os cancelamentos são feitos no painel ou na conta do cliente pela chamada de cancelamento de reserva, conforme essa política.

Continue a explorar

Mais sobre a plataforma