빠른 시작

​

List 조회 엔드포인트 시작하기

이 빠른 시작 가이드는 Postman을 사용해 List 조회 엔드포인트로 첫 요청을 보내는 방법을 안내합니다.

다양한 언어의 샘플 코드를 보고 싶다면 X API v2 샘플 코드 GitHub 저장소를 방문하세요.

참고: 이 예제에서는 id로 List 조회 엔드포인트에 요청을 보내지만, 이 빠른 시작에서 배운 내용을 다른 조회 요청에도 적용할 수 있습니다.

​

사전 준비 사항

이 가이드를 완료하려면 요청 인증을 위한 키와 토큰이 필요합니다. 다음 단계를 따라 키와 토큰을 생성할 수 있습니다:

• 개발자 계정에 신청하고 승인을 받습니다.
• 개발자 포털에서 Project와 연결된 Developer 앱을 생성합니다.
• App의 “Keys and tokens” 페이지로 이동하여 필요한 자격 증명을 생성합니다. 모든 자격 증명은 안전한 위치에 보관하세요.

​

리스트 조회 요청을 구성하는 단계

1단계: 도구 또는 라이브러리부터 시작하기

이 엔드포인트에 요청을 보내는 데 사용할 수 있는 도구, 코드 예제, 라이브러리가 여러 가지 있지만, 여기서는 과정을 단순화하기 위해 Postman을 사용하겠습니다.

X API v2 Postman 컬렉션을 환경에 불러오려면 아래 버튼을 클릭하세요:

Postman에 X API v2 추가

Postman에 X API v2 컬렉션을 불러온 후 “List” 폴더로 이동하고 “List lookup” 폴더를 선택한 다음 “List by ID”를 선택하세요.  

2단계: 요청 인증

X API에 정상적으로 요청하려면 권한이 있는지 확인해야 합니다. 이 엔드포인트의 경우 앱 전용, OAuth 2.0 Authorization Code with PKCE, 또는 OAuth 1.0a 사용자 컨텍스트 인증 방식으로 요청을 인증해야 합니다.

단순화를 위해 이 요청에서는 앱 전용을 사용하겠습니다. 다만 비공개 지표 또는 리스트에 접근하려면 다른 인증 방식 중 하나를 사용해야 합니다. 

앱 전용을 사용하려면 Postman에서 오른쪽 상단의 “X API v2” 환경을 선택한 뒤, “initial value” 및 “current value” 필드에(환경 드롭다운 옆 눈 아이콘 클릭) 키와 토큰(특히 App only Access Token)을 추가해야 합니다.

올바르게 설정했다면, 이러한 변수는 요청의 authorization 탭에 자동으로 반영됩니다.  

3단계: 가져올 리스트 식별 및 지정

요청에서 수신하려는 리스트를 지정해야 합니다. x.com에서 리스트를 클릭한 뒤 URL에서 리스트 ID를 확인할 수 있습니다. 예를 들어 다음 URL의 리스트 ID는 84839422입니다.

https://x.com/i/lists/84839422

대상 ID는 유효한 리스트 ID라면 무엇이든 가능합니다. Postman에서 “Params” 탭으로 이동해 id 경로 변수의 “Value” 열에 자신의 ID를 입력하세요. ID 앞뒤에 공백이 없도록 주의하세요.

Key	Value
id	84839422 (리스트 ID)

4단계: 가져올 필드 식별 및 지정

3단계 후 “Send” 버튼을 클릭하면 응답으로 기본 List 객체 필드인 id, name을 받게 됩니다.

추가 필드를 받으려면 요청에 list.fields 및/또는 expansions 파라미터로 해당 필드를 지정해야 합니다.

이번 연습에서는 서로 다른 오브젝트에서 세 가지 추가 필드 집합을 요청합니다:

• 기본 Lists 오브젝트의 추가 created_at 필드
• expansions 파라미터를 사용한 전체 user 객체
• 연관된 user 객체의 추가 user.created_at 필드

Postman에서 “Params” 탭으로 이동하여 “Query Params” 표에 다음 key:value 쌍을 추가하세요:

Key	Value	Returned fields
list.fields	created_at	created_at
expansions	owner_id	includes.users.id, includes.users.name, includes.users.username
user.fields	created_at	includes.users.created_at

이제 “Send” 버튼 옆에 다음과 유사한 URL이 표시되어야 합니다:

https://api.x.com/2/lists/84839422?list.fields=owner_id&expansions=owner_id&user.fields=created_at

5단계: 요청 전송 및 응답 검토

모든 설정이 완료되면 “Send” 버튼을 눌러 다음 예시와 유사한 응답을 받게 됩니다:

{
  "data": {
    "id": "84839422",
    "name": "Twitter 공식 계정",
    "owner_id": "783214"
  },
  "includes": {
    "users": [
      {
        "name": "Twitter",
        "created_at": "2007-02-20T14:35:54.000Z",
        "username": "Twitter"
        "id": "783214"
      }
    ]
  }
}