Ir para o conteúdo

Transforme as suas conexões em um bônus de fim de ano com o nosso novo Programa de Indicação de Clientes! Saiba mais

✕

Esta documentação é para a versão 4 e posterior do App Builder, o novo nome do Vinyl. Acesse a documentação do Vinyl aqui.

✕

Configurando o Twitter no Jitterbit App Builder

O App Builder não oferece suporte nativo ao Twitter, nem como um provedor de autenticação nem de dados. No entanto, como a API do Twitter é fundamentalmente uma API REST, protegida usando o fluxo de Credencial de Cliente OAuth, é possível usar o provedor de segurança HTTP genérico do App Builder para recuperar dados do Twitter.

A documentação do Twitter para autenticação em nível de aplicativo usando o fluxo de credenciais do cliente OAuth pode ser encontrada aqui:

https://dev.twitter.com/oauth/application-only

As principais tarefas envolvidas incluem:

  1. Registre o App Builder como um aplicativo do Twitter.
  2. Crie um provedor de segurança HTTP do Twitter
  3. Crie uma fonte de dados do Twitter.

Presume-se que sua organização já tenha uma conta no Twitter.

Registre o App Builder como um aplicativo do Twitter

Comece entrando no site do Twitter Application Management.

https://apps.twitter.com/

  1. Clique no botão Criar novo aplicativo (canto superior direito)

  2. Forneça as seguintes informações:

    • Nome: Um nome lógico para o ambiente ou aplicativo do App Builder.

      Exemplo: ACMEApp BuilderDev

    • Descrição: Uma descrição do ambiente ou aplicativo do App Builder.

      Exemplo: desenvolvimento de aplicativos App Builder na ACME.

    • Site: URL do aplicativo web do App Builder.

      Exemplo: https://dev.example.com/App Builder/

  3. Aceite o contrato do desenvolvedor

  4. Clique no botão Criar seu aplicativo do Twitter

  5. Em Configurações do aplicativo, anote as seguintes propriedades:

    • Autenticação somente de aplicativo: Este será o valor do TokenEndpoint ao configurar o provedor de segurança HTTP no App Builder.

      Exemplo: https://api.twitter.com/oauth2/token

  6. Em Configurações do aplicativo, clique no link gerenciar chaves e tokens de acesso

  7. Anote as seguintes propriedades:

    • Chave do consumidor (chave de API): Este será o valor do ClientId ao configurar o provedor de segurança HTTP no App Builder.
    • Consumer Secret (API Secret): Este será o valor do ClientSecret ao configurar o provedor de segurança HTTP no App Builder.

Crie um provedor de segurança HTTP do Twitter

Para criar um provedor de segurança HTTP, comece entrando no App Builder como administrador.

  1. Navegue até o IDE
  2. Selecione o botão Provedores de segurança
  3. No painel Autenticação do usuário, clique no botão + Autenticação do usuário

  4. Forneça o seguinte:

    • Nome: Twitter
    • Tipo: HTTP

    • Prioridade: Um inteiro exclusivo entre 10 e 100. Observe que esse valor deve ser único.

      Exemplo: 50

    • Habilitado: Verificar

  5. Clique no botão Salvar

  6. Defina as seguintes propriedades. No painel Propriedades, clique no botão + Propriedade → Selecione o Parâmetro → Forneça o Valor → Clique no ícone Salvar.

    • Tipo de autenticação: Credenciais do cliente

    • TokenEndpoint: O provedor de endpoint {App-only Authentication} do Twitter.

      Exemplo: https://api.twitter.com/oauth2/token

    • ClientId: A {Consumer Key} fornecida pelo Twitter

    • ClientSecret: O {Segredo do Consumidor} fornecido pelo Twitter

Crie uma fonte de dados do Twitter

Para criar uma fonte de dados do Twitter, comece entrando no App Builder como administrador.

  1. Navegue até o IDE
  2. Selecione o botão Servidores de Dados
  3. No painel Servidores de Dados, clique no botão + Servidor

  4. Forneça o seguinte:

    • Nome: Twitter
    • Tipo: API REST
    • URL: https://api.twitter.com/1.1/
    • Provedor de segurança: Twitter

  5. Clique no botão Salvar

  6. Clique no ícone Tabelas para adicionar as informações dos Endpoints
  7. No painel Endpoints, clique no botão + Endpoint

  8. Forneça o seguinte:

    • Nome: user_timeline
    • Endpoint: statuses/user_timeline.json

  9. Clique no botão Salvar

  10. Clique no ícone Fechar (X) para fechar o pop-up do Endpoint
  11. No painel Parâmetros de Endpoint, clique no botão + Parâmetro

  12. Forneça o seguinte:

    • Nome: screen_name
    • Tipo de dados: String
    • Valor de teste: twitterapi

  13. Clique em Salvar

  14. Clique no ícone Fechar (X) para fechar o pop-up Parâmetro de entrada
  15. No painel Parâmetros do serviço da Web, clique no botão + Parâmetro

  16. Forneça o seguinte:

    • Nome: contagem
    • Tipo de dados: Inteiro
    • Uso: Limite de solicitação

  17. Clique no ícone Fechar (X) para fechar o pop-up do parâmetro do serviço da Web

  18. No painel Endpoints, clique no botão Descobrir

    Este processo de descoberta preencherá o painel Tabelas de Saída.

  19. No painel Tabelas de saída, localize a tabela user_timeline e clique no ícone Conteúdo.

Supondo que tudo tenha sido configurado corretamente, você deverá ver uma linha do tempo para a conta twitterapi.