- Ferramentas úteis
- Conceitos-chave
Guias
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 gerenciamento de Bookmarks ao seu sistema. Organizamos a página em algumas seções:
Antes de abordarmos alguns conceitos essenciais que ajudarão você a integrar este endpoint, recomendamos que você se familiarize com:
O Postman é uma excelente ferramenta 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 no Postman, visite a página “Usando o Postman”.
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.
Aproveite uma das bibliotecas de terceiros da nossa comunidade para começar. Você pode encontrar uma biblioteca compatível com os endpoints v2 buscando pela tag de versão correspondente.
Todos os endpoints da X API v2 exigem que você autentique suas solicitações com um conjunto de credenciais, também conhecido como chaves e tokens.
Esses endpoints específicos exigem o uso do Authorization Code Flow do OAuth 2.0 com PKCE, o que significa que você deve usar um conjunto de chaves 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 uma Authorize URL.
Observe que o OAuth 2.0 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.
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 nesse Projeto. Em seguida, você 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 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. Há um limite por usuário de 180 requisições por janela de 15 min para o método GET. Com o método GET do endpoint de consulta de Bookmarks, você receberá 800 dos seus Posts mais recentes salvos nos Bookmarks. Além disso, há um limite por usuário de 50 requisições por 15 minutos para os métodos POST e DELETE.
⌘I