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:
- Registrar o App Builder como um aplicativo do Twitter.
- Criar um provedor de segurança HTTP do Twitter
- 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.
- Clique no botão Create New App (canto superior direito)
-
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/
-
-
Concorde com o acordo de desenvolvedor
- Clique no botão Create your Twitter application
-
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
-
-
Em Application Settings, clique no link manage keys e access tokens
-
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.
- Navegue até a IDE
- Selecione o botão Security Providers
- Clique no botão + Security Provider
-
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
-
Clique no botão Save
-
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.
- Navegue até a IDE
- Selecione o botão Data Servers
- No painel Data Servers, clique no botão + Server
-
Forneça o seguinte:
- Name: Twitter
- Type: REST API
- URL: https://api.twitter.com/1.1/
- Security Provider: Twitter
-
Clique no botão Save
- Clique no ícone Tables para adicionar as informações de Endpoints
- No painel Endpoints, clique no botão + Endpoint
-
Forneça o seguinte:
- Name: user_timeline
- Endpoint: statuses/user_timeline.json
-
Clique no botão Save
- Clique no ícone Close (X) para fechar o popup de Endpoint
- No painel Endpoint Parameters, clique no botão + Parameter
-
Forneça o seguinte:
-
Nome: screen_name
- Tipo de dado: String
-
Valor de teste: twitterapi
-
Clique em Salvar
- Clique no ícone Fechar (X) para descartar o popup Input Parameter
- No painel Web Service Parameters, clique no botão + Parameter
-
Forneça o seguinte:
- Nome: count
- Tipo de dado: Integer
- Uso: Request Limit
-
Clique no ícone Fechar (X) para descartar o popup Web Service Parameter
-
No painel Endpoints, clique no botão Discover
Este processo de descoberta preencherá o painel Output Tables.
-
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.