

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 a serviços de terceiros e APIs (genérico)
<a name="connectors-api"></a>

Use o procedimento a seguir para criar um **conector de API** genérico no App Studio. O **API Connector** é usado para fornecer aos aplicativos do App Studio acesso a serviços, recursos ou operações de terceiros.

**Para se conectar a serviços de terceiros com o **API Connector****

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 **API Connector**. Agora, configure seu conector preenchendo os campos a seguir.

1. **Nome do conector:** forneça um nome para seu conector.

1. **Descrição do conector:** forneça uma descrição para seu conector.

1. **URL base:** o site ou host da conexão de terceiros. Por exemplo, .`www.slack.com`

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:** ideal para system-to-system interações em que o aplicativo age em seu próprio nome sem a interação do usuário. Por exemplo, um aplicativo de CRM que atualiza registros do Salesforce automaticamente com base em novos registros adicionados pelos usuários ou um aplicativo que recupera e exibe dados de transações em relatórios.

        1. Em **ID do cliente**, insira a ID obtida do OAuth aplicativo criado no serviço de destino.

        1. Em **Segredo do cliente**, insira o segredo obtido do OAuth aplicativo criado no serviço de destino.

        1. Em **URL do token de acesso**, insira o URL do token obtido do OAuth aplicativo criado no 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.

        Escolha **Verificar conexão** para testar a autenticação e a conexão.

     1. **Fluxo de código de autorização:** ideal para aplicativos que exigem ação em nome de um usuário. Por exemplo, um aplicativo de suporte ao cliente em que os usuários fazem login e visualizam e atualizam tíquetes de suporte, ou um aplicativo de vendas em que cada membro da equipe faz login para visualizar e gerenciar seus dados de vendas.

        1. Em **ID do cliente**, insira a ID obtida do OAuth aplicativo criado no serviço de destino.

        1. Em **Segredo do cliente**, insira o segredo obtido do OAuth aplicativo criado no 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 obtido do OAuth aplicativo criado no 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. **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. 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.