Pular para o conteúdo principal

Introdução

Projetos permitem organizar seu trabalho com base em como você pretende usar a X API, para que você possa gerenciar de forma eficaz seu acesso à API e monitorar seu uso. Cada Projeto pode conter um ou vários Apps, dependendo do seu nível de acesso (descrito mais adiante nesta página). Você usará esses Apps para gerar credenciais de autenticação, como API Keys and Secrets, Access Tokens de usuário e App Access Token. Embora você possa usar essas chaves e tokens de qualquer App para acessar a X API ou a X Ads API (você deve solicitar acesso adicional para usar a X Ads API), é necessário usar chaves e tokens de um App associado a um Projeto para poder usar os endpoints da X API v2. Se você tem uma conta de desenvolvedor, pode visualizar e gerenciar seus Projetos na página Projects & Apps no portal do desenvolvedor. Inscreva-se para obter uma conta se ainda não tiver uma.

Projetos e níveis de acesso da X API

No momento, existem 4 níveis de acesso diferentes aplicados no nível do Projeto:
  • Free
  • Basic
  • Pro
  • Enterprise
Para saber mais sobre o que cada nível de acesso oferece, visite a página sobre a X API. Você só pode ter um único Projeto com Free, Basic ou Pro. A seguir, descrevemos algumas diferenças específicas de Projeto:

Gratuito

Este nível de acesso é disponibilizado a qualquer pessoa que se inscreveu para uma conta de desenvolvedor. Número de Apps neste Projeto: 1 Limite de consumo de Tweets: 1.500 Tweets por mês Métodos de autenticação:

Basic

Este nível de acesso é disponibilizado a qualquer pessoa que tenha assinado o acesso Basic por meio do portal do desenvolvedor. Número de Apps dentro desse Projeto: 2 Tweet consumption cap: 10.000 Tweets por mês Métodos de autenticação:

Pro

Este nível de acesso é disponibilizado a qualquer pessoa que assinou o Pro pelo portal do desenvolvedor. Número de Apps neste Projeto: 3 Limite de consumo de Tweets: 1 milhão de Tweets por mês Métodos de autenticação:

Enterprise

Este nível de acesso é oferecido a qualquer pessoa que tenha solicitado o Enterprise, sido aprovada por nossa equipe e assinado um contrato mensal com renovação automática por meio do gerente de contas da X. Candidate-se aqui. Número de Apps dentro desse Projeto: 3+ Tweet consumption cap: mais de 50 milhões de Tweets por mês Métodos de autenticação:

Limites de Tweets e Projetos

Os limites de consumo de Tweets se aplicam no nível do Projeto, restringindo o volume de Tweets que você pode recuperar de determinados endpoints da X API v2 em um determinado mês. Saiba mais sobre limites de Tweets.

Configurando Projetos

Criando um Projeto

Para criar um Projeto, clique em “New Project” no seu dashboard ou na página Projects & Apps dentro do portal do desenvolvedor. Você só verá essa opção se ainda não tiver criado um Projeto. Você será solicitado a informar um nome para o Projeto, uma descrição e um caso de uso. Também será solicitado que você crie um novo App ou conecte um App autônomo existente.

Criando ou conectando um App ao seu Projeto

Se o seu Projeto não tiver um App, você pode adicionar um clicando no nome do Projeto no painel. A partir daí, você pode criar um novo App ou selecionar um App autônomo já existente para conectar ao seu Projeto. O App é onde você pode gerar as chaves e tokens de autenticação mencionados no início deste guia.

Editando um Projeto

Para editar um Projeto, clique no nome do seu Projeto no painel ou na página Projects & Apps dentro do portal do desenvolvedor. A partir daí, você verá os detalhes do seu Projeto e poderá selecionar “edit” para fazer alterações.

Apps independentes

Apps independentes são Apps que existem fora da estrutura de Projeto. As credenciais de autenticação associadas a essas Apps independentes podem fazer solicitações bem-sucedidas às APIs da X: Standard v1.1, premium v1.1, Enterprise ou à X Ads API. Apps independentes falharão ao tentar fazer solicitações aos endpoints da X API v2, a menos que você as conecte a um Projeto. Se você criou uma App antes de agosto de 2020, ela ficará visível na seção “Standalone Apps” do portal do desenvolvedor em Projects & Apps. Você terá um limite total de dez Apps, incluindo aquelas conectadas ao seu Projeto. Se você faz parte de uma conta em equipe, verá as Apps que você possui em Standalone Apps. Se um colega possuir uma App que faça parte de um Projeto, você poderá ver o nome da App e as informações do proprietário, mas não poderá alterar suas configurações, acessar suas chaves e tokens ou regenerar suas chaves e tokens. Você deve entrar em contato com o proprietário da App para fazer quaisquer alterações na App dele.
I