- Ferramentas úteis
- Conceitos-chave
- Autenticação
- Portal do desenvolvedor, Projetos e Apps
- Limites de requisições
- Rótulos de origem
- Configurações de perfil
- Adicionando mídia a um Post
Guias
Guia de integração
Esta página contém informações sobre várias ferramentas e conceitos-chave que você precisa conhecer ao integrar os endpoints de gerenciamento de Posts ao seu sistema. Dividimos a página em algumas seções:
Antes de abordarmos alguns conceitos fundamentais que ajudarão você a integrar este endpoint, recomendamos que você se familiarize com:
Postman é uma excelente ferramenta que você pode usar para testar um endpoint. Cada requisição do Postman inclui todos os parâmetros de caminho e de corpo para ajudar você a entender rapidamente o que está disponível. Para saber mais sobre nossas coleções do Postman, visite a página “Using Postman”.
Interessado em configurar este endpoint com código na sua linguagem de programação preferida? Temos vários exemplos de código disponíveis que você pode usar como ponto de partida na nossa página no GitHub.
Aproveite uma das bibliotecas de terceiros da nossa comunidade para começar. Você pode encontrar uma biblioteca compatível com os endpoints v2 procurando pela tag de versão apropriada.
Todos os endpoints da X API v2 exigem que você autentique suas solicitações com um conjunto de credenciais, também conhecidas como chaves e tokens.
Esses endpoints específicos exigem o uso de Contexto de Usuário do OAuth 1.0a, o que significa que você deve usar um conjunto de API Keys e Access Tokens de usuário para realizar uma solicitação com sucesso. Os Access Tokens devem estar associados ao usuário em cujo nome você está fazendo a solicitação. Se você quiser gerar um conjunto de Access Tokens para outro usuário, ele deverá autorizar ou autenticar sua App usando o fluxo OAuth de 3 etapas.
Observe que o OAuth 1.0a pode ser difícil de usar. Se você não estiver familiarizado com esse método de autenticação, recomendamos usar uma biblioteca, uma ferramenta como o Postman ou o OAuth 2.0 para autenticar suas solicitações.
OAuth 2.0 Authorization Code com PKCE permite maior controle sobre o escopo de uma aplicação e fluxos de autorização em vários dispositivos. O OAuth 2.0 permite escolher escopos específicos e granulares que concedem permissões específicas em nome de um usuário.
Para habilitar o OAuth 2.0 na sua App, você deve ativá-lo nas configurações de autenticação da sua App, localizadas na seção de configurações da App no portal do desenvolvedor.
Para obter um conjunto de credenciais de autenticação que funcione com os endpoints da X API v2, você deve ter uma conta de desenvolvedor, configurar um Projeto nessa conta e criar um App de desenvolvedor dentro desse Projeto. Em seguida, você poderá encontrar suas chaves e tokens no seu App de desenvolvedor.
Todos os dias, muitos milhares de desenvolvedores fazem requisições à X API. Para ajudar a gerenciar o grande volume dessas requisições, limites de taxa são aplicados a cada endpoint, limitando o número de requisições que você pode fazer em nome da sua App ou de um usuário autenticado.
Esses endpoints têm limites no nível do usuário, o que significa que o usuário autenticado em cujo nome você está fazendo a requisição só pode chamar o endpoint um certo número de vezes em qualquer App de desenvolvedor. Há um limite de taxa por usuário de 200 requisições por 15 minutos para o método POST. O método DELETE tem um limite de taxa de 50 requisições por 15 minutos. Além disso, há um limite de 300 requisições por 3 horas, incluindo Posts criados com manage Posts ou manage Retweets.
O nome da sua App e a URL do site serão exibidos como o rótulo de origem nos metadata de quaisquer Posts criados programaticamente pela sua aplicação. Se você alterar o caso de uso de uma X App, certifique-se de atualizá-lo nessas configurações para garantir a conformidade com os Termos do Desenvolvedor.
Você só pode adicionar uma localização aos Posts se tiver o recurso de geolocalização ativado nas configurações do seu perfil. Se não tiver a geolocalização ativada, ainda poderá incluir um parâmetro de localização no corpo da solicitação, mas ele não será associado ao seu Post. O mesmo vale para marcar usuários em imagens. Se o usuário que você está marcando não tiver a marcação de fotos ativada, o nome dele não aparecerá na lista de usuários marcados, mesmo que o Post seja criado com sucesso.
Atualmente, não há uma maneira de fazer o upload completo de mídia usando a v2 da X API. No entanto, você pode anexar a um Post mídias que já tenham sido enviadas anteriormente. Você pode usar ids de mídia que já foram enviados usando o endpoint de mídia da v1 ou o X Media Studio. Esses ids de mídia devem ser seus ou de um usuário autenticado.
Próximos passos
Referência da API
⌘I