Glossário

Nesta página, você encontra definições resumidas dos termos usados na documentação do Cloud Endpoints e links para ver mais informações sobre eles.

API: Uma interface REST que facilita o consumo de recursos ou dados de um aplicativo por outro aplicativo Ao definir pontos de entrada estáveis, simples e bem documentados, as APIs permitem que os desenvolvedores acessem e reutilizem facilmente a lógica do aplicativo criada por outros desenvolvedores.
Configurar API: Criado quando você faz o upload de uma definição de API para o gateway de API. Sempre que você fizer o upload de uma definição de API, o gateway de API criará uma nova configuração de API. Ou seja, você pode criar uma configuração de API, mas não será possível modificá-la depois. Se você editar a definição da API e depois fazer upload da definição, criará uma nova configuração de API.
Definição de API: Uma especificação da API aberta 2.0 ou uma configuração do gRPC usado para criar uma configuração de API. A definição de API especifica: o URL do serviço de back-end, o formato dos dados transmitidos em uma solicitação, o formato dos dados retornados pelo serviço, o mecanismo de autenticação usado para controlar o acesso ao serviço e muitas outras opções.
Chave de API: Um código transmitido por um aplicativo cliente quando ele chama uma API. As chaves de API identificam o aplicativo ou projeto do Google Cloud que está fazendo a chamada para a API. Consulte Por que e quando usar chaves de API para mais informações sobre o uso de uma chave de API com sua API do Endpoints.
Auth0: Serviço para definir o método de autenticação dos usuários nos aplicativos. Consulte Auth0 para mais informações.
CORS: O compartilhamento de recursos entre origens (CORS, na sigla em inglês) é uma especificação que permite que aplicativos da Web acessem recursos em um servidor em outro domínio (tecnicamente, em outra origem). Para saber mais sobre o CORS, consulte os documentos da Web da Mozilla Developer Network (MDN) e o Fetch Living Standard.
Firebase authentication: Serviço de autenticação do Google que oferece suporte para login de usuários finais em aplicativos clientes. São usadas credenciais de provedores de identidade conhecidos e federados, como Google, Facebook ou Twitter. Consulte Firebase Authentication para mais informações.
Gateway: Um proxy escalonável, de alto desempenho e baseado no Envoy que hospeda a configuração da API implantada. A criação de um gateway cria o URL externo que seus clientes de API usam para acessar a API. Um gateway hospeda apenas uma única configuração de API. Não é possível implantar várias configurações de API no mesmo gateway.
Token de ID do Google: OpenID Connect necessários para identificar uma conta de usuário do Google ou conta de serviço e que é assinado pelo serviço de autenticação do Google, https://accounts.google.com.
gRPC: Framework de RPC de alto desempenho, código aberto e universal desenvolvido pelo Google. Com o gRPC, um aplicativo cliente pode chamar métodos diretamente em um aplicativo servidor em uma outra máquina, como se fosse um objeto local. Consulte Visão geral do gRPC para informações sobre como usar o gRPC com o gateway de API e o site do gRPC (em inglês) para informações gerais.
JWT: O JSON Web Token (JWT) é um formato de token de acesso com padrão aberto. É usado em cabeçalhos de autorização HTTP e em parâmetros de consulta de URI. Para informações gerais, consulte Introdução ao JSON Web Tokens
OpenAPI: Iniciativa OpenAPI é um esforço de todo o setor para padronizar a descrição de APIs REST. As APIs descritas com a Especificação OpenAPI (anteriormente conhecida como Especificação Swagger) podem ser compatíveis com ferramentas comuns que criam documentação, automatizam testes e geram códigos para clientes e servidores. Consulte a Visão geral da OpenAPI para mais informações.
Documento da OpenAPI: Um arquivo no formato YAML ou JSON que você usa para descrever a API. Esse arquivo também é conhecido como definição de API. Quando enviado para o gateway de API, o documento da OpenAPI é convertido em uma configuração de API.
Superfície: A interface pública de uma API. A superfície de uma API consiste nos métodos, parâmetros e tipos de retorno usados nos métodos.