Introdução às APIs

Aproveite os dados da Expedia com autenticação e autorização

Para usar as APIs da plataforma de viagens do Expedia Group, você deve criar um ou mais clientes de API, que são como contas de usuário protegidas por senha. Em resumo, um cliente de API estabelece que o software que faz uma solicitação da API pertence a você (autenticação) e permite limitar os tipos de solicitações de API que cada cliente pode fazer (autorização).

Testar com o nosso recurso Sandbox

O Fraud Prevention Service ativou o recurso Sandbox, que permite testar os resultados da API sem que sejam refletidos no seu aplicativo de produção. Experimente as APIs do Fraud Prevention Service com credenciais específicas de sandbox em nosso API Explorer, no Postman ou em outras ferramentas e teste as suas configurações antes de ativá-las.

Leia mais instruções de como testar APIs no ambiente do Sandbox no artigo Sandbox do Fraud Prevention.

Criar um cliente de API

Seja para começar no modo sandbox ou acessar logo o modo on-line, você pode criar e gerenciar os seus clientes de API no console do Expedia Group. Antes de criar um cliente de API, você precisa adicionar produtos à sua conta.

Passos:

No console, clique no link para criar cliente de API no canto inferior esquerdo.
Na página de criação de novo cliente de API, dê ao cliente um nome e uma descrição que ajude você e outras pessoas na sua organização a lembrar quais produtos estão incluídos nele.
Na lista de produtos disponíveis, marque as caixas ao lado dos escopos, ou seja, os tipos de solicitação de API, que deseja incluir. Marcar a caixa no nível superior seleciona todos os elementos secundários.
Clique na opção para conseguir credenciais.
Copie e salve as suas credenciais em um local seguro.

Observação: as credenciais da API são exibidas apenas no momento em que o cliente é criado, então você precisa copiar e salvar esses dados antes de prosseguir. Você não vai poder exibir essas informações de novo.

Você pode criar quantos clientes de API precisar. Cada cliente pode receber permissões específicas, assim é possível limitar o que cada um dos seus serviços de software pode fazer na plataforma de viagens do Expedia Group.

Produtos e escopos

Todos os clientes de API funcionam em uma mesma conta de parceiro. Os produtos adicionados à conta ficam disponíveis para serem incluídos em um cliente de API. É possível criar um único cliente de API com acesso a um ou mais produtos.

Cada produto inclui um conjunto de escopos que concedem acesso a determinados tipos de solicitação. Os escopos que você atribui definem o que o cliente tem autorização para fazer. Se você tem vários serviços de software fazendo solicitações de API, é recomendável criar um cliente de API separado para cada serviço e selecionar apenas os escopos necessários para cada cliente.

Credenciais de cliente

Cada cliente de API recebe um ID e um segredo para autenticação, semelhante a um nome de usuário e senha. As credenciais são exibidas apenas no momento em que o cliente é criado, então você vai precisar copiar e salvar esses dados antes de prosseguir.

Guarde bem as suas credenciais de cliente de API. Não armazene o seu ID de cliente nem o segredo em áreas de acesso público, como GitHub, códigos do lado do cliente etc.

Conhecer

Se você quiser testar as APIs no API Explorer, está tudo pronto! Você pode inserir a chave do cliente de API (client_id) e o segredo na interface do usuário do API Explorer alternando o botão Show authentication section.

Para saber como incorporar um cliente de API no seu software, consulte Autenticação e autorização de APIs.