Antes de contratar uma empresa de integração de API em Dubai

Há três orçamentos na mesa. Cada empresa de integração mostra um portfólio de sites de viagem, cada uma promete "conectar uma API de voos ao seu site", e a mais barata pode começar na semana que vem. Você tem uma agência em Deira, seis funcionários e uma carteira corporativa estável, e já cansou de copiar tarifas da extranet do fornecedor para mensagens de WhatsApp. Escolher a empresa de integração de API em Dubai que parece mais competente dá a sensação de ser a decisão inteira.
É mais ou menos um terço dela. O que decide se o site vende não está em nenhum dos três orçamentos, porque não é código. É com quem o contrato de fornecimento foi assinado, em nome de quem as passagens são emitidas, onde fica o dinheiro entre a reserva e a emissão, e quem cuida do reembolso quando o cliente cancela. Um integrador consegue ligar tudo isso. Não consegue ser nenhuma dessas coisas por você.
Este texto é para o dono que vai assinar o escopo do projeto, não para o desenvolvedor que vai lê-lo.
O que uma empresa de integração de API em Dubai entrega, e o que não entrega
Uma empresa de integração escreve o código entre a API de um fornecedor e o seu site: o formulário de busca, a chamada que consulta disponibilidade, a checagem de preço antes do pagamento, o pedido de reserva, as telas que mostram o resultado e, se o escopo prever, as chamadas de cancelamento e reembolso. As boas também cuidam da parte chata que importa: novas tentativas quando o fornecedor demora a responder, logs que permitem rastrear uma reserva que falhou, um ambiente de teste que se comporta como o de produção.
O que ela não pode entregar é tudo o que fica do outro lado desse código. Antes de escrever a primeira linha, a agência precisa ter:
- uma conta no fornecedor em nome da própria agência, com acesso à API liberado para essa conta;
- autoridade de emissão, seja credenciamento próprio, seja um consolidador que emita por ela;
- um acordo financeiro com esse fornecedor: depósito, linha de crédito ou pagamento com cartão repassado;
- alguém que faça o trabalho pós-emissão (voids, reembolsos, reemissões, mudanças de horário), pela API ou, se não der, à mão.
O integrador que se oferece para "resolver a parte do fornecedor" geralmente está oferecendo emprestar a dele. Para um protótipo, pode ser um atalho razoável. Para um negócio, significa que o seu site de reservas roda sobre uma relação que não é sua e que você não leva quando sair.
O briefing: sete linhas para o escopo do projeto
A maioria das brigas com integradores nasce de uma frase que ninguém escreveu. Coloque estas no documento que você assina, em linguagem simples, e peça cada resposta por escrito.
- Em nome de quem estão a conta no fornecedor e as chaves de API. Da agência. Chaves são credenciais: ficam no seu cofre de senhas, e o integrador recebe acesso, não a posse.
- Quem hospeda o site e quem é dono do domínio. O domínio é registrado em nome da agência. A conta de hospedagem é da agência, ou o contrato diz exatamente como ela é transferida.
- Quais operações entram no escopo. Liste pelo nome: busca, preço, reserva, emissão, cancelamento, reembolso, alteração. O que não estiver na lista continua sendo um e-mail para o balcão do fornecedor enquanto o site existir. Reembolsos e alterações são os que mais faltam, porque nenhuma demonstração os mostra.
- Quem mantém a integração quando o fornecedor muda a API. Fornecedores aposentam versões e renomeiam campos. Um projeto de preço fechado sem cláusula de manutenção termina no dia em que a primeira versão muda.
- O que significa entrega. Código-fonte em um repositório que pertence à agência, todas as credenciais e um documento que permita a outro desenvolvedor continuar o trabalho. "Mandamos um zip" não é entrega.
- Como se prova que está pronto. Uma reserva de teste da busca até a emissão no ambiente de teste do fornecedor, incluindo um cancelamento, antes de alguém passar o cartão de um cliente de verdade.
- O que acontece com os dados dos clientes. Nomes de passageiros, dados de passaporte e referências de pagamento: onde ficam guardados, quem pode lê-los e como são apagados.
Nenhum desses itens exige formação técnica para ser escrito. Todos saem mais baratos combinados antes da obra do que negociados depois dela.
Três caminhos para levar conteúdo de fornecedor ao seu site
Contratar um integrador contra a API de um fornecedor é um dos caminhos. Vale a pena olhá-lo ao lado dos outros dois antes que um orçamento faça a escolha por você.
| Caminho | Quem detém a relação com o fornecedor | Quem mantém a conexão funcionando | O que a agência ainda precisa construir | Quanto custa sair |
|---|---|---|---|---|
| Integrador liga seu site à API de um fornecedor | A agência, se o briefing disser; senão, muitas vezes o integrador | O integrador sob contrato de manutenção, ou ninguém | Painel, markups, cadastro de clientes, relatórios, pagamentos, telas de pós-venda | Pouco se o código e as chaves forem seus; refazer tudo se não forem |
| Integrador liga seu site à API de uma plataforma | A plataforma tem os contratos com fornecedores; a agência tem a conta na plataforma | A plataforma do lado do fornecedor; o integrador do seu lado | Seu site, e o que a API da plataforma não cobrir | Reescrever o seu lado contra outra API |
| Loja white-label que já vem conectada | A plataforma, por meio da conta da agência | A plataforma | Conteúdo, decisões de preço, seus próprios clientes | Mover o domínio e a lista de clientes para outro provedor |
A linha que merece discussão é a primeira. Ela dá o maior controle e joga mais coisa nas suas costas: cada mudança do fornecedor, cada novo serviço e cada operação que ficou de fora na primeira versão vira outro projeto, com outro orçamento.
Como colocar busca em um site que você já tem está em adicionar busca de voos a um site existente, e como escolher de quem é a API por trás dela, em o que existe por trás de um fornecedor de API de reservas de voos. Este texto trata do contrato em volta do trabalho.
Onde esta plataforma se encaixa
A plataforma por trás deste blog oferece APIs de voos e de hotéis. O acesso começa com uma conversa, não com uma chave gerada sozinha, porque as primeiras perguntas são as de cima (quais serviços, qual mercado, como o dinheiro circula) e não qual endpoint chamar. Os serviços são ativados por conta, e cada conta tem o próprio painel administrativo com reservas, clientes, markups e relatórios, então a coluna "ainda precisa construir" da segunda linha é mais curta do que parece.
Se uma empresa de integração vai construir o seu lado, tenha essa conversa antes de aceitar um orçamento, para que o escopo descreva a API à qual ela vai de fato se conectar. A página de APIs de viagem é o ponto de partida.
Quanto custa um briefing fraco
O site entra no ar. A busca funciona, os preços parecem certos, e a primeira reserva chega numa quinta-feira à noite. Ela não pode ser emitida em nome da sua agência, porque a conta no fornecedor é do integrador e emite pelo acordo dele. O cartão do cliente já foi cobrado. Agora você tem uma reserva que não consegue emitir nem reembolsar pelo seu próprio site.
Ou funciona por um ano. Aí o fornecedor muda de versão de API, as reservas param, e o integrador, cujo contrato de preço fechado acabou na entrega, manda orçamento de um projeto novo. Você paga, porque as únicas pessoas que entendem o código são as que estão orçando.
Ou o integrador simplesmente está ocupado com outra coisa. Um cliente precisa corrigir o nome numa passagem, a operação de alteração nunca entrou no escopo, e duas pessoas da sua equipe passam a tarde mandando e-mail para o balcão do fornecedor. É exatamente o trabalho que o site deveria ter tirado de vocês.
Em todos os casos faltou uma frase no briefing. O código estava certo todas as vezes.