Introdução

​

Consulta de membros da List

O grupo de consulta de membros tem dois endpoints disponíveis. Você pode obter detalhes sobre os membros de uma List específica e ver de quais Lists um usuário faz parte. Esses endpoints podem ser usados para ajudar as pessoas a criar e organizar novas Lists com base nas informações de associação.

Há um limite de taxa de 900 solicitações por 15 minutos ao consultar detalhes de membros e um limite de 75 solicitações por 15 minutos ao consultar associações de usuários.

Você pode usar Contexto de Usuário do OAuth 1.0a, App only ou OAuth 2.0 Authorization Code com PKCE para autenticar suas solicitações a este endpoint.   

​

Gerenciar membros da List

Os endpoints para gerenciar membros de uma List permitem adicionar e remover membros de uma List em nome de um usuário autenticado. Para esses endpoints, há dois métodos disponíveis: POST e DELETE. O método POST permite adicionar um membro a uma List, e o método DELETE permite remover um membro de uma List. Há um limite de taxa por usuário de 300 solicitações a cada 15 minutos para ambos os endpoints.

Observe que Lists não podem ter mais de 5.000 membros.

Como você está fazendo solicitações em nome de um usuário com esses endpoints, deve autenticá-lo com OAuth 1.0a User Context ou OAuth 2.0 Authorization Code with PKCE e usar os Access Tokens associados a um usuário que autorizou sua App, os quais podem ser gerados usando o fluxo OAuth de 3 etapas (OAuth 1.0a) ou o fluxo de concessão Authorization Code com PKCE (OAuth 2.0).

Configuração da conta

Para acessar esses endpoints, você precisará de:

• Uma conta de desenvolvedor aprovada.
• Autenticar-se usando as chaves e tokens de uma App de desenvolvedor que esteja localizada dentro de um Projeto.

Saiba mais sobre como obter acesso aos endpoints da X API v2 em nosso guia de Introdução.

Introdução rápida

Exemplo de código

Executar no Postman

Testar com o API Explorer