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
Um Token da Web JSON (JWT) que contém os campos do
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
A
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.