As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Conecte-se aos serviços com a OpenAPI
<a name="connectors-openapi"></a>

Para conectar o App Studio a serviços usando a OpenAPI para permitir que os criadores criem aplicativos que enviem solicitações e recebam respostas dos serviços, execute as seguintes etapas:

1. [Obtenha o arquivo de especificação da OpenAPI e reúna informações do serviço](#connectors-openapi-create-resources)

1. [Criar conector OpenAPI](#connectors-openapi-create-connector)

## Obtenha o arquivo de especificação da OpenAPI e reúna informações do serviço
<a name="connectors-openapi-create-resources"></a>

Para conectar um serviço ao App Studio com a OpenAPI, execute as seguintes etapas:

1. Acesse o serviço que você deseja conectar ao App Studio e encontre um arquivo JSON de especificação OpenAPI.
**nota**  
O App Studio é compatível com arquivos de especificação OpenAPI que estão em conformidade com a versão 3.0.0 ou superior da especificação OpenAPI.

1. Reúna os dados necessários para configurar o conector OpenAPI, incluindo o seguinte:
   + O URL base para conexão com o serviço.
   + Credenciais de autenticação, como um token ou nome de usuário/senha.
   + Se aplicável, qualquer cabeçalho.
   + Se aplicável, qualquer parâmetro de consulta.

## Criar conector OpenAPI
<a name="connectors-openapi-create-connector"></a>

**Para criar um conector para a OpenAPI**

1. Navegue até o App Studio.

1. **No painel de navegação do lado esquerdo, escolha **Conectores** na seção Gerenciar.** Você será direcionado para uma página exibindo uma lista de conectores existentes com alguns detalhes sobre cada um.

1. Escolha **\$1 Criar conector**.

1. Escolha **OpenAPI Connector** na lista de tipos de conectores. Agora, configure seu conector preenchendo os campos a seguir.

1. **Nome:** insira um nome para seu conector OpenAPI.

1. **Descrição:** insira uma descrição para seu conector OpenAPI.

1. **URL base:** insira a URL base para se conectar ao serviço.

1. **Método de autenticação:** escolha o método de autenticação com o serviço de destino.
   + **Nenhum:** acesse o serviço de destino sem autenticação.
   + **Básico:** acesse o serviço de destino usando um **nome de usuário** e **senha** obtidos do serviço ao qual está conectado.
   + **Token do portador:** acesse o serviço de destino usando o **valor do token** de um token de autenticação obtido da conta de usuário ou das configurações da API do serviço.
   + **OAuth 2.0:** acesse o serviço de destino usando o protocolo OAuth 2.0, que concede ao App Studio acesso ao serviço e aos recursos sem compartilhar nenhuma credencial ou identidade. Para usar o método de autenticação OAuth 2.0, primeiro você deve criar um aplicativo a partir do serviço conectado que represente o App Studio para obter as informações necessárias. Com essas informações, preencha os seguintes campos:

     1. **Fluxo de credenciais do cliente:**

        1. Em **ID do cliente**, insira a ID do serviço de destino.

        1. Em **Segredo do cliente**, insira o segredo do serviço de destino.

        1. Em **URL do token de acesso**, insira o URL do token do serviço de destino.

        1. Opcionalmente, em **Escopos**, insira os escopos do aplicativo. Os escopos são permissões ou níveis de acesso exigidos pelo aplicativo. Consulte a documentação da API do serviço de destino para entender seus escopos e configurar somente aqueles de que seu aplicativo do App Studio precisa.

        Adicione quaisquer **variáveis** a serem enviadas com o serviço em cada chamada e escolha **Verificar conexão** para testar a autenticação e a conexão.

     1. **Fluxo do código de autorização:**

        1. Em **ID do cliente**, insira a ID do serviço de destino.

        1. Em **Segredo do cliente**, insira o segredo do serviço de destino.

        1. Em **URL de autorização**, insira a URL de autorização do serviço de destino.

        1. Em **URL do token de acesso**, insira o URL do token do serviço de destino.

        1. Opcionalmente, em **Escopos**, insira os escopos do aplicativo. Os escopos são permissões ou níveis de acesso exigidos pelo aplicativo. Consulte a documentação da API do serviço de destino para entender seus escopos e configurar somente aqueles de que seu aplicativo do App Studio precisa.

1. **Variáveis:** adicione variáveis a serem enviadas ao serviço com cada chamada. As variáveis adicionadas durante a configuração são armazenadas com segurança e acessadas somente durante o tempo de execução dos aplicativos que usam a conexão.

1. **Cabeçalhos:** adicione cabeçalhos HTTP usados para fornecer metadados sobre a solicitação ou a resposta. Você pode adicionar chaves e valores ou fornecer apenas uma chave para a qual o construtor possa fornecer um valor no aplicativo.

1. **Parâmetros de consulta:** adicione parâmetros de consulta usados para transmitir opções, filtros ou dados como parte da URL da solicitação. Assim como os cabeçalhos, você pode fornecer uma chave e um valor, ou apenas fornecer uma chave para a qual o construtor possa fornecer um valor no aplicativo.

1. Arquivo de **especificação OpenAPI: faça upload de um arquivo** JSON da especificação OpenAPI arrastando e soltando ou escolhendo **Selecionar um arquivo** para navegar no sistema de arquivos local e escolha o arquivo a ser carregado.

   Depois de adicionado, o arquivo é processado e uma lista das opções disponíveis é exibida. Selecione as operações necessárias para seu conector.

1. Escolha **Criar**. O conector recém-criado aparecerá na lista de **conectores**.

Agora que o conector foi criado, os criadores podem usá-lo em seus aplicativos.