Guia de Integração

Esta página contém informações sobre várias ferramentas e conceitos essenciais que você deve conhecer ao integrar os endpoints de List ao seu sistema. Dividimos a página em algumas seções:

• Ferramentas úteis
• Conceitos essenciais
• Autenticação
• Portal do desenvolvedor, Projetos e Apps
• Limites de requisições

​

Ferramentas úteis

Antes de abordarmos alguns conceitos-chave que ajudarão você a integrar este endpoint, recomendamos que você se familiarize com:

​

Postman

O Postman é uma ótima ferramenta que você pode usar para testar um endpoint. Cada requisição no 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 “Usando o Postman”. 

​

Exemplos de código

Quer 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.

​

Bibliotecas de terceiros

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.

​

Conceitos principais

​

Autenticação

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 do 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 fazer uma solicitação bem-sucedida. 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 complexo de usar. Se você não estiver familiarizado com esse método de autenticação, recomendamos usar uma biblioteca ou uma ferramenta como o Postman para autenticar suas solicitações corretamente.  

​

Portal do desenvolvedor, Projetos e Apps de desenvolvedor

Para obter um conjunto de credenciais de autenticação que funcione com os endpoints da X API v2, você deve criar uma conta de desenvolvedor, configurar um Projeto nessa conta e criar um App de desenvolvedor dentro desse Projeto. Em seguida, você encontrará suas chaves e tokens no seu App de desenvolvedor.  

​

Limites de requisições

Todos os dias, muitos milhares de desenvolvedores fazem requisições à X API. Para ajudar a gerenciar o grande volume dessas requisições, limites de requisições são aplicados a cada endpoint, restringindo 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. 

A tabela abaixo mostra os limites de requisições para cada endpoint.

Endpoint	método HTTP	limite de taxa
/2/lists	POST	300 requests por 15 minutos
/2/lists/:id	DELETE / PUT	300 requests por 15 minutos