Pular para o conteúdo principal

​
Introdução aos endpoints de gerenciamento de Posts**

Este guia de Introdução rápida ajudará você a fazer sua primeira requisição aos endpoints de gerenciamento de Posts usando o Postman. Visite nosso repositório no GitHub X API v2 sample code se quiser ver exemplos de código em diferentes linguagens.
Pré-requisitosPara concluir este guia, você precisará de um conjunto de chaves e tokens para autenticar sua requisição. Você pode gerar essas chaves e tokens seguindo estas etapas:

​
Etapas para criar solicitações de gerenciamento de Posts

Etapa um: comece com uma ferramenta ou biblioteca Há várias ferramentas, exemplos de código e bibliotecas que você pode usar para fazer uma solicitação a este endpoint, mas aqui usaremos o Postman para simplificar o processo. Para carregar a coleção do X API v2 no seu ambiente do Postman, clique no botão a seguir:
Depois de carregar a coleção do X API v2 no Postman, navegue até a pasta “Manage Posts” e selecione “Create a Post”.   Etapa dois: autentique sua solicitação Para fazer corretamente uma solicitação ao X API, você precisa verificar se tem permissão para isso. Para fazer isso com os endpoints de gerenciamento de Posts, você deve autenticar sua solicitação usando OAuth 1.0a User Context ou OAuth 2.0 Authorization Code com PKCE. Neste exemplo, usaremos OAuth 1.0a User Context. Você deve adicionar suas chaves e tokens (especificamente sua API Key, Chave secreta da API, OAuth 1.0a user Access Token e OAuth 1.0a user Access Token Secret) ao Postman. Você pode fazer isso selecionando o ambiente chamado “X API v2” (no canto superior direito do Postman) e adicionando suas chaves e tokens aos campos “initial value” e “current value” (clicando no ícone de olho ao lado do seletor de ambientes). Se você fez isso corretamente, essas variáveis serão preenchidas automaticamente na guia de autorização da solicitação. Etapa três: especifique o texto do Post Ao criar um novo Post com este endpoint, o texto ou a mídia do Post são os parâmetros obrigatórios do corpo. No Postman, navegue até a guia “Body” e insira o texto do Post como o valor do parâmetro text. Além disso, se desejar adicionar parâmetros para itens como enquetes, responder a um ID do Post ou ajustar as configurações de resposta, você também pode fazer isso aqui. Você pode saber mais sobre o que está disponível em nosso guia de referência da API.
KeyValueParameter type
textHello world!body
Etapa quatro: identifique e especifique quais fields você deseja recuperar Depois que tudo estiver configurado, clique no botão “Send” e você receberá uma resposta semelhante ao exemplo a seguir: 
{
  "data": {
    "id": "1445880548472328192",
    "text": "Olá, mundo!"
  }
}
Se o objeto de resposta retornado contiver um id e o text do seu Post, o Post foi criado com sucesso.   Etapa cinco: Excluir seu Post Para excluir um Post, selecione a requisição “Delete a Post”, também localizada na pasta “Manage Posts” da coleção X API v2 carregada no Postman. Este endpoint requer o ID do Post que você deseja excluir. Em seguida, na guia “Params”, insira o ID do Post que você deseja excluir como valor na coluna id.  Em caso de solicitação DELETE bem-sucedida, você receberá uma resposta semelhante ao seguinte exemplo: 
{
   "data": {
       "deleted" : true
   }
}
Próximos passos Referência da API Obter suporte Exemplo de código
⌘I