Introdução às APIs

Para usar as APIs da plataforma Expedia Group, você deve criar um ou mais clientes de API. Um cliente de API é como uma conta de usuário protegida por senha. Em resumo, ele 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 APIs que cada cliente pode fazer (autorização).

Criar um cliente de API

Crie e gerencie clientes de API no console.

Etapas:

Faça login na sua conta existente ou configure uma nova conta de usuário e forneça as informações básicas necessárias sobre a empresa.
(Opcional) crie uma nova conta de parceiro para usar no teste.
Selecione e configure o produto que você deseja usar.
Solicite um cliente de API (use o ícone "+" no canto inferior esquerdo).

Você pode criar quantos clientes de API precisar. Cada cliente pode receber permissões específicas, permitindo que você limite o que cada um dos seus serviços de software pode fazer na plataforma Expedia Group.

Selecionar produtos e escopos

Todos os clientes de API operam em uma única conta de parceiro. Você pode selecionar e configurar vários produtos em uma única conta de parceiro, e todos os produtos configurados são listados quando você cria um novo cliente. Você pode criar um único cliente de API e conceder a ele o acesso a um ou mais produtos na conta de parceiro.

Cada produto define um conjunto de "escopos" que concedem acesso a determinados tipos de solicitação. Os escopos que você atribui a um cliente de API definem o que ele está autorizado a fazer. Se você tiver vários serviços de software fazendo solicitações de API, crie um cliente de API separado para cada serviço e selecione apenas os escopos necessários para cada cliente.

Copiar as credenciais de cliente

Cada cliente de API recebe uma chave 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. Portanto, você vai precisar copiar esses dados e salvá-los antes de prosseguir.

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

Hora de explorar

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 da API Explorer usando o botão "Authorize".

Para saber como incorporar um cliente de API no seu software, leia a próxima seção.