Ir para o conteúdo

Configurando o Twitter no Jitterbit App Builder

O App Builder não suporta nativamente o Twitter, nem como um provedor de autenticação ou de dados. No entanto, como a API do Twitter é fundamentalmente uma API REST, protegida usando o fluxo de Credenciais 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 de Cliente OAuth pode ser encontrada aqui:

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

As principais tarefas envolvidas incluem:

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

Assume-se que sua organização já possui uma conta do Twitter existente.

Registrar o App Builder como um aplicativo do Twitter

Comece fazendo login no site de Gerenciamento de Aplicativos do Twitter.

https://apps.twitter.com/

  1. Clique no botão Criar Novo App (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 aplicativo do App Builder na ACME.

    • Website: URL do aplicativo web do App Builder.

      Exemplo: https://dev.example.com/Vinyl/

  3. Concorde com o contrato de desenvolvedor

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

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

    • Autenticação apenas para aplicativo: Este será o valor do TokenEndpoint ao configurar o provedor de segurança HTTP dentro do 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 da API): Este será o valor do ClientId ao configurar o provedor de segurança HTTP dentro do App Builder.
    • Segredo do Consumidor (Segredo da API): Este será o valor do ClientSecret ao configurar o provedor de segurança HTTP dentro do App Builder.

Criar um provedor de segurança HTTP do Twitter

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

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

  4. Forneça o seguinte:

    • Nome: Twitter
    • Tipo: HTTP

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

      Exemplo: 50

    • Habilitado: Marcar

  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.

    • AuthenticationType: ClientCredentials

    • TokenEndpoint: O endpoint de {Autenticação apenas para App} fornecido pelo Twitter.

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

    • ClientId: A {Chave do Consumidor} fornecida pelo Twitter

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

Criar uma fonte de dados do Twitter

Para criar uma fonte de dados do Twitter, comece fazendo login 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: REST API
    • 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 de 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 dispensar o popup do Endpoint
  11. No painel de Parâmetros do Endpoint, clique no botão + Parâmetro

  12. Forneça o seguinte:

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

  13. Clique em Salvar

  14. Clique no ícone Fechar (X) para dispensar o popup de Parâmetro de Entrada
  15. No painel de Parâmetros do Serviço Web, clique no botão + Parâmetro

  16. Forneça o seguinte:

    • Nome: count
    • Tipo de dado: Inteiro
    • Uso: Limite de Solicitação

  17. Clique no ícone Fechar (X) para dispensar o popup de Parâmetro do Serviço Web

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

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

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

Assumindo que tudo foi configurado corretamente, você deverá ver uma linha do tempo para a conta twitterapi.