목록 멤버 조회
리스트 멤버 관리
계정 설정이 엔드포인트에 액세스하려면 다음이 필요합니다:
- 승인된 개발자 계정
- Project 내에 있는 Developer 앱의 키와 토큰을 사용한 인증
리스트 멤버 목록
소개
멤버 조회 그룹에는 두 개의 엔드포인트가 제공됩니다. 지정된 목록의 멤버 세부 정보를 가져오고, 사용자가 어떤 목록의 멤버인지 확인할 수 있습니다. 이 엔드포인트는 멤버십 정보를 바탕으로 새 목록을 선별하고 구성하는 데 활용할 수 있습니다.
멤버 세부 정보를 조회할 때는 15분당 900건, 사용자 멤버십을 조회할 때는 15분당 75건의 요청 한도가 있습니다.
이 엔드포인트에 대한 요청을 인증하려면 OAuth 1.0a 사용자 컨텍스트, 앱 전용, 또는 OAuth 2.0 Authorization Code with PKCE를 사용할 수 있습니다.
리스트 멤버 관리 엔드포인트는 인증된 사용자를 대신해 리스트에 멤버를 추가하거나 제거할 수 있도록 합니다. 이 엔드포인트에서는 POST와 DELETE 두 가지 메서드를 사용할 수 있습니다. POST는 리스트에 멤버를 추가하고, DELETE는 리스트에서 멤버를 제거합니다. 두 엔드포인트 모두 사용자 기준 15분당 300개의 요청 제한이 적용됩니다.
리스트의 멤버 수는 5,000명을 초과할 수 없습니다.
이 엔드포인트로 사용자를 대신해 요청하는 경우, OAuth 1.0a 사용자 컨텍스트 또는 OAuth 2.0 Authorization Code with PKCE로 인증해야 하며, 귀하의 App을 승인한 사용자의 사용자 액세스 토큰을 사용해야 합니다. 이 토큰은 3-legged OAuth 플로우 (OAuth 1.0a) 또는 Authorization Code with PKCE grant flow (OAuth 2.0)을 통해 생성할 수 있습니다.