Demo ao vivo

Guia

O que é integração de API, explicado para empresas de viagens

Uma integração de API é uma ligação que permite a dois sistemas de software trocar dados e disparar ações sem que ninguém volte a digitar nada. Este guia explica como funciona com uma reserva de hotel que viaja entre um viajante, uma plataforma de reservas, a API de um fornecedor e um gateway de pagamento.

  • Um pedido, uma resposta
  • REST, XML, SOAP e webhooks
  • Uma reserva seguida por quatro sistemas
  • Como as integrações são testadas

A definição

O que é integração de API, em linguagem simples

API significa interface de programação de aplicações: o conjunto de regras que um sistema publica para que outro software possa falar com ele. Integração de API é o trabalho de ligar a sua plataforma a uma dessas interfaces para que os dados circulem e as ações aconteçam automaticamente.

Em viagens, essa plataforma costuma ser um sistema de reservas como Software de reservas de viagens, e a interface pertence a um fornecedor, um gateway de pagamento ou uma ferramenta de negócio. A nossa página de Integração de API de viagens explica como a PHPTRAVELS entrega estas ligações, e o Todas as integrações lista os fornecedores já ligados.

  • Trocar dados

    Tarifas, disponibilidade, dados de clientes e atualizações de estado circulam entre sistemas num formato estruturado.

  • Automatizar ações

    Pesquisar, reservar, pagar, cancelar e conciliar acontecem como pedidos, não como passos que alguém repete à mão.

  • Rastrear resultados

    Cada chamada leva uma referência, por isso uma reserva falhada pode ser rastreada até ao pedido que a causou.

Pedido

POST /v1/hotels/availability HTTP/1.1Host: api.supplier.exampleAuthorization: Bearer sk_test_••••••••Content-Type: application/json{  "city": "DXB",  "check_in": "2026-11-12",  "check_out": "2026-11-14",  "guests": 2,  "currency": "USD"}

Resposta

HTTP/1.1 200 OKContent-Type: application/jsonX-Request-Id: req_7f3a91{  "hotel": "Palm Marina Hotel",  "room": "Deluxe, 2 adults",  "rate": { "amount": 438.00, "currency": "USD" },  "refundable": true,  "rate_key": "rk_19d2c7"}
Chamada de exemplo a um fornecedor hoteleiro fictício. Nomes de campos, endpoints e valores variam de fornecedor para fornecedor.

Anatomia de uma chamada à API

  1. 1

    Endpoint e método

    O endereço da operação e o verbo usado sobre ela: POST em availability significa procurar quartos.

  2. 2

    Autenticação

    Uma chave, token ou assinatura prova quem está a chamar. Os fornecedores emitem credenciais separadas para sandbox e produção.

  3. 3

    Payload

    A entrada estruturada: cidade, datas, hóspedes e moeda. A documentação do fornecedor define cada campo.

  4. 4

    Código de estado

    Um número que diz como correu a chamada: 200 é sucesso, 4xx um problema no pedido, 5xx um problema do lado do fornecedor.

  5. 5

    ID do pedido

    Um identificador que ambos os lados guardam. Quando o suporte pergunta o que aconteceu a uma reserva, é isto que procuram.

  6. 6

    Corpo da resposta

    A resposta no formato do fornecedor, que a sua plataforma mapeia para os seus próprios quartos, tarifas e políticas.

Uma reserva, quatro sistemas

O que a integração de API faz durante uma reserva de hotel

Acompanhe uma estadia de duas noites da pesquisa ao voucher. Cada seta é uma chamada à API; o viajante só vê a primeira e a última.

  1. 01ViajantePlataforma de reservasPesquisa hotéis no Dubai, duas noites, dois hóspedes
  2. 02Plataforma de reservasAPI do fornecedorPedido de disponibilidade com datas, hóspedes e moeda
  3. 03API do fornecedorPlataforma de reservasQuartos, tarifas, políticas e uma chave de tarifa
  4. 04Plataforma de reservasViajanteResultados mostrados com a sua margem e moeda aplicadas
  5. 05Plataforma de reservasAPI do fornecedorReverificação do preço na chave de tarifa escolhida antes do pagamento
  6. 06Plataforma de reservasGateway de pagamentoAutorização de pagamento pelo total
  7. 07Gateway de pagamentoPlataforma de reservasAutorizado, webhook assinado recebido
  8. 08Plataforma de reservasAPI do fornecedorPedido de reserva com os dados do hóspede
  9. 09API do fornecedorPlataforma de reservasNúmero de confirmação e condições de cancelamento
  10. 10Plataforma de reservasViajanteVoucher, fatura e referência da reserva

A plataforma no meio é onde vive a integração de API: traduz entre o ecrã do viajante e o formato de cada fornecedor, e guarda todas as referências.

A mesma sequência serve Software de reserva de voos com um GDS, Software para operadoras de turismo com um fornecedor de atividades e Integração de gateways de pagamento com qualquer gateway; só mudam os nomes dos campos.

Estilos de integração

REST, XML, SOAP, webhooks e GraphQL

Os fornecedores publicam as suas interfaces em estilos diferentes. O estilo é decidido pela documentação do fornecedor, não por preferência, por isso uma plataforma de viagens precisa de falar todos.

  • REST e JSON

    JSON
    Formato de dados
    Documentos JSON
    Transporte
    Métodos HTTP: GET, POST, PUT, DELETE
    Habitual em viagens
    APIs mais recentes de voos, hotéis, atividades e pagamentos
    Ponto forte
    Payloads compactos e vasta ferramenta para programadores
    Atenção a
    Pouco especificado; cada fornecedor interpreta REST à sua maneira

  • XML e SOAP

    XML
    Formato de dados
    Documentos XML, muitas vezes com esquema rígido
    Transporte
    HTTP POST com envelope SOAP ou XML simples
    Habitual em viagens
    GDS, bedbanks e sistemas hoteleiros e de tours estabelecidos
    Ponto forte
    Contratos formais, assinaturas e definições de serviço
    Atenção a
    Mensagens extensas e parsing mais pesado

  • Webhooks

    EVENT
    Formato de dados
    JSON ou XML, enviado pelo outro lado
    Transporte
    HTTP POST para um URL que regista
    Habitual em viagens
    Resultados de pagamento, mudanças de estado de reservas, emissão de bilhetes
    Ponto forte
    Sem polling; a sua plataforma é avisada quando algo acontece
    Atenção a
    As assinaturas têm de ser verificadas e as repetições tratadas

  • GraphQL

    QUERY
    Formato de dados
    JSON, com a forma da consulta que envia
    Transporte
    Um único endpoint HTTP
    Habitual em viagens
    Algumas plataformas de distribuição recentes e APIs internas
    Ponto forte
    Pede exatamente os campos de que precisa
    Atenção a
    O suporte dos fornecedores de viagens ainda é pouco comum

Integração de API versus desenvolvimento de API

Integração de API

Liga o seu produto a uma interface que já existe. O fornecedor é dono da API; você constrói o cliente, o mapeamento e as regras à volta.

Desenvolvimento de API

Cria uma interface que outros sistemas usam para se ligarem ao seu produto, como uma API B2B que as ferramentas dos seus agentes podem chamar. Você é dono do contrato e das suas versões.

Muitos projetos de viagens precisam de ambos: a plataforma integra fornecedores de um lado e publica a sua própria API para agentes e parceiros do outro.

Antes e depois

O que muda quando os sistemas estão integrados

Os mesmos cinco passos de uma reserva, feitos à mão nos portais dos fornecedores e feitos através de integração de API.

Pesquisar

Sem integraçãoManual

Um agente abre o portal de cada fornecedor e copia os preços para um orçamento.

Com integração de APIAutomático

Uma pesquisa distribui-se por todos os fornecedores ligados e devolve uma única lista.

Preço

Sem integraçãoManual

A margem é adicionada numa folha de cálculo; a tarifa pode ter mudado quando o orçamento é enviado.

Com integração de APIAutomático

Margem, impostos e regras de moeda aplicam-se na resposta; a tarifa é reverificada antes do pagamento.

Reservar

Sem integraçãoManual

Os dados do hóspede são digitados de novo no portal do fornecedor; gralhas tornam-se erros de reserva.

Com integração de APIAutomático

Os dados são enviados uma vez, validados e guardados com a confirmação do fornecedor.

Pagar

Sem integraçãoManual

O pagamento é cobrado à parte e associado à reserva mais tarde.

Com integração de APIAutomático

Autorização, captura e reembolso ficam ligados à referência da reserva.

Assistir

Sem integraçãoManual

Cancelamentos e alterações significam outro login e outro e-mail.

Com integração de APIAutomático

Alterações e cancelamentos passam pela mesma ligação e atualizam o registo.

Onde a integração de API aparece numa plataforma de viagens

Vocabulário

Termos que vai encontrar na documentação de API

Doze palavras que aparecem em quase todos os portais de programadores dos fornecedores, definidas como são usadas em viagens.

  • API

    Interface de programação de aplicações: as regras publicadas para falar com um sistema.

  • Autenticação

    Provar quem está a chamar, com uma chave de API, um token bearer, uma assinatura ou um endereço IP aprovado.

  • Certificação

    A revisão que um fornecedor faz à sua integração antes de emitir credenciais de produção.

  • Endpoint

    Um endereço para uma operação, como pesquisar, reservar ou cancelar.

  • Idempotência

    Enviar o mesmo pedido duas vezes produz um só resultado, o que evita reservas e cobranças duplicadas.

  • Mapeamento

    Traduzir os campos, códigos e nomes do fornecedor para o modelo de dados da sua plataforma.

  • Payload

    Os dados transportados dentro de um pedido ou resposta, normalmente JSON ou XML.

  • Limite de pedidos

    O número de chamadas que um fornecedor permite por segundo ou por dia antes de começar a recusá-las.

  • Pedido e resposta

    Uma chamada: a sua plataforma pergunta, o fornecedor responde e ambos os lados registam.

  • Sandbox

    Um ambiente de testes com inventário fictício e cartões de teste onde nada é realmente reservado nem cobrado.

  • Código de estado

    O número HTTP que resume o resultado: 200 sucesso, 401 não autorizado, 429 limite excedido, 500 erro do fornecedor.

  • Webhook

    Uma chamada no sentido inverso: o fornecedor ou o gateway notifica a sua plataforma quando ocorre um evento.

Testes e âmbito

Como uma integração de API de viagens é testada antes de entrar em produção

Uma integração só está terminada quando os caminhos infelizes se comportam bem. Uma execução de testes contra a sandbox do fornecedor cobre os casos abaixo antes da certificação e da passagem a credenciais de produção.

run integration tests

sandbox do fornecedor, nove casos

  • OK: Autenticação com credenciais válidas e expiradas
  • OK: Pedido inválido rejeitado com um erro legível
  • OK: Timeout do fornecedor tratado sem reserva pendurada
  • OK: Limite de pedidos respeitado e nova tentativa após a espera
  • OK: Alteração de preço apanhada na reverificação e mostrada antes do pagamento
  • OK: A submissão duplicada devolve a primeira reserva, não uma segunda
  • OK: Cancelamento aplicado e taxas calculadas
  • OK: Reembolso emitido contra o pagamento original
  • OK: Referências de reserva, pagamento e fornecedor conciliam

Todos os casos passaram, pronto para certificação

O que a definição do âmbito precisa de si

  1. 1Acordo com o fornecedor, documentação e credenciais de sandbox
  2. 2Mercados, moedas, produtos e perfis de utilizador
  3. 3Âmbito de pesquisa, reserva, alteração, cancelamento e reembolso
  4. 4Requisitos de certificação e processo de acesso a produção

Pronto para ligar um fornecedor

A PHPTRAVELS integra fornecedores, gateways e ferramentas de negócio numa plataforma auto-hospedada entregue com o código-fonte. Veja Preços para os três planos de pagamento único, ou pergunte-nos sobre uma API específica.

Pedir uma demonstraçãoFale connosco

Continue a ler

Perguntas

Perguntas sobre integração de API, respondidas

Respostas curtas às perguntas que as pessoas fazem antes do primeiro projeto de integração.

Fale com vendas

Integração de API é uma ligação que permite a dois sistemas de software trocar dados e disparar ações automaticamente. Um sistema envia um pedido estruturado, o outro devolve uma resposta estruturada, e ambos seguem regras acordadas de segurança e dados.

Em viagens liga uma plataforma de reservas a fornecedores de voos, hotéis, tours ou carros, gateways de pagamento e ferramentas de negócio. Suporta pesquisa, validação de preço, reserva, cancelamento, reembolsos e conciliação sem redigitação.

REST é um estilo arquitetural que normalmente troca JSON sobre HTTP. XML é um formato de dados ainda comum entre GDS e bedbanks, muitas vezes envolvido em SOAP. O contrato e a documentação do fornecedor decidem qual usa.

Depende do acesso ao fornecedor, dos endpoints no âmbito, da certificação, das regras de mapeamento e dos casos limite de reserva. Uma estimativa fiável surge depois de rever a documentação, as credenciais e os fluxos de que precisa.

Teste autenticação, pedidos válidos e inválidos, timeouts, limites de pedidos, alterações de preço, submissões duplicadas, cancelamentos, reembolsos e conciliação. Em produção, cada pedido deve ser rastreável até uma referência de reserva.

Não. A integração liga o seu produto a uma API existente; o desenvolvimento cria uma interface à qual outros se ligam. As plataformas de viagens precisam muitas vezes de ambos: fornecedores integrados de um lado e uma API B2B publicada para parceiros do outro.

Continue a explorar

Mais sobre a plataforma