Ir para o conteúdo

Configurando o Twitter

O Vinyl não oferece suporte nativo ao Twitter, seja como provedor de autenticação ou de dados. No entanto, como a API do Twitter é fundamentalmente uma API REST, protegida pelo fluxo de credenciais do cliente OAuth, é possível usar o provedor de segurança HTTP genérico do Vinyl 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 Vinyl 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 Vinyl Como um Aplicativo do Twitter

Comece fazendo login no site 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 Vinyl.

      Exemplo: ACMEVinylDev

    • Descrição: Uma descrição do ambiente ou aplicação do Vinyl.

      Exemplo: Desenvolvimento de aplicação de Vinyl na ACME.

    • Site: URL do aplicativo web de Vinyl.

      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 somente de aplicativo: Este será o valor do TokenEndpoint ao configurar o provedor de segurança HTTP no Vinyl.

      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:

    • Consumer Key (API Key): Este será o valor do ClientId ao configurar o provedor de segurança HTTP dentro do Vinyl.
    • Consumer Secret (API Secret): Este será o valor do ClientSecret ao configurar o provedor de segurança HTTP dentro do Vinyl.

Crie um Provedor de Segurança HTTP do Twitter

Para criar um provedor de segurança HTTP, comece entrando no Vinyl 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 número inteiro exclusivo entre 10 e 100. Observe que esse valor deve ser exclusivo.

      Exemplo: 50

    • Ativado: Verifique

  5. Clique no botão Salvar

  6. Defina as propriedades a seguir. 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 {chave do consumidor} fornecida pelo Twitter

    • ClientSecret: O {Consumer Secret} fornecido pelo Twitter

Crie uma Fonte de Dados do Twitter

Para criar uma fonte de dados do Twitter, comece entrando no Vinyl 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 Endpoint
  11. No painel Endpoint Parameters, clique no botão + Parameter

  12. Forneça o seguinte:

    • Nome: nome_tela
    • Tipo de dados: String
    • Valor do 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 de 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 Parâmetro de serviço da Web

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

    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 do Twitterapi.