Ir para o conteúdo

Configurando o Twitter no Jitterbit App Builder

O App Builder não oferece suporte nativo ao Twitter, nem como provedor de autenticação nem de dados. Porém, como a API do Twitter é fundamentalmente uma API REST protegida pelo fluxo OAuth Client Credential, é possível usar o provedor HTTP genérico do App Builder para recuperar dados do Twitter.

A documentação do Twitter sobre autenticação em nível de aplicação usando o fluxo OAuth Client Credentials está disponível 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.

Pressupõe-se que sua organização já possua uma conta do Twitter.

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 Create New App (canto superior direito)
  2. Forneça as seguintes informações:

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

      Exemplo: ACMEApp BuilderDev

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

      Exemplo: Desenvolvimento de aplicativos do App Builder na ACME.

    • Website: URL da aplicação web do App Builder.

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

  3. Concorde com o acordo de desenvolvedor

  4. Clique no botão Create your Twitter application
  5. Em Application Settings, anote as seguintes propriedades:

    • App-only authentication: 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 Application Settings, clique no link manage keys e access tokens

  7. Anote as seguintes propriedades:

    • Consumer Key (API Key): 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.

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é a IDE
  2. Selecione o botão Security Providers
  3. Clique no botão + Security Provider
  4. Forneça o seguinte:

    • Name: Twitter
    • Type: HTTP
    • Priority: Um número inteiro exclusivo entre 10 e 100. Note que este valor deve ser exclusivo.

      Exemplo: 50

    • Enabled: Marque

  5. Clique no botão Save

  6. Defina as seguintes propriedades. No painel Properties, clique no botão + Property → Selecione o Parameter → Forneça o Value → Clique no ícone Save.

    • AuthenticationType: ClientCredentials
    • TokenEndpoint: O endpoint de {App-only Authentication} fornecido pelo Twitter.

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

    • ClientId: A {Consumer Key} fornecida pelo Twitter

    • ClientSecret: O {Consumer Secret} 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é a IDE
  2. Selecione o botão Data Servers
  3. No painel Data Servers, clique no botão + Server
  4. Forneça o seguinte:

    • Name: Twitter
    • Type: REST API
    • URL: https://api.twitter.com/1.1/
    • Security Provider: Twitter
  5. Clique no botão Save

  6. Clique no ícone Tables para adicionar as informações de Endpoints
  7. No painel Endpoints, clique no botão + Endpoint
  8. Forneça o seguinte:

    • Name: user_timeline
    • Endpoint: statuses/user_timeline.json
  9. Clique no botão Save

  10. Clique no ícone Close (X) para fechar o popup de Endpoint
  11. No painel Endpoint Parameters, clique no botão + Parameter
  12. Forneça o seguinte:

  13. Nome: screen_name

  14. Tipo de dado: String
  15. Valor de teste: twitterapi

  16. Clique em Salvar

  17. Clique no ícone Fechar (X) para descartar o popup Input Parameter
  18. No painel Web Service Parameters, clique no botão + Parameter
  19. Forneça o seguinte:

    • Nome: count
    • Tipo de dado: Integer
    • Uso: Request Limit
  20. Clique no ícone Fechar (X) para descartar o popup Web Service Parameter

  21. No painel Endpoints, clique no botão Discover

    Este processo de descoberta preencherá o painel Output Tables.

  22. No painel Output Tables, localize a tabela user_timeline e clique no ícone Content.

Assumindo que tudo foi configurado corretamente, você verá uma timeline da conta twitterapi.