고정 목록 조회

참고: 이 가이드는 빠른 시작 개요에 있는 사전 준비를 완료했다고 가정합니다.

​

고정된 리스트 조회 요청을 만드는 단계

1단계: Postman에서 List 엔드포인트 컬렉션 선택

Postman에 X API v2 컬렉션을 로드한 후 “List” 폴더로 이동하고, “Pinned Lists” 폴더를 선택한 다음 “User’s pinned Lists”를 선택하세요.  

2단계: 사용자 식별 및 지정

사용자의 고정된 리스트를 가져오려면 요청에 해당 사용자의 사용자 ID를 지정해야 합니다. 사용자 ID는 인증에 사용되는 사용자 ID와 일치해야 하며, 즉 요청을 인증할 때 해당 사용자 ID와 연결된 액세스 토큰을 전달해야 합니다. 이 예시에서는 본인의 사용자 ID를 지정할 수 있습니다. ID는 다음 두 가지 방법으로 확인할 수 있습니다:

1. users lookup by username 엔드포인트를 사용하여 사용자 이름을 전달하면 id 필드를 받을 수 있습니다.
2. 액세스 토큰의 숫자 부분이 본인의 사용자 ID입니다.

Postman에서 “Params” 탭으로 이동하여 id 매개변수의 “Value” 열에 이 사용자 ID를 입력하세요.

Key	Value
id	2244994945 (user ID)

3단계: 가져올 필드 지정

이 단계까지 완료한 뒤 “Send” 버튼을 클릭하면 응답에 기본 List object 필드인 id 및 name이 반환됩니다.

id 및 name 외의 추가 필드를 받으려면 요청에서 field 및/또는 expansion 매개변수를 사용해 해당 필드를 지정해야 합니다.

이 연습에서는 서로 다른 객체에서 세 가지 추가 필드 세트를 요청합니다:

• 기본 List 객체의 추가 follower_count 필드
• expansion 매개변수를 사용한 전체 user object
• 연결된 사용자 객체의 추가 tweet.created_at 필드

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

Key	Value	Returned fields
list.fields	follower_count	follower_count
expansions	owner_id	includes.users.id, <br/>includes.users.name, <br/>includes.users.username
user.fields	created_at	includes.users.created_at

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

https://api.x.com/2/users/2244994945/pinned_lists?expansions=owner_id&list.fields=follower_count&user.fields=created_at

4단계: 요청 실행 및 응답 검토

모든 설정을 마쳤다면 “Send” 버튼을 클릭하세요. 그러면 아래 예시와 유사한 응답을 받게 됩니다:

{
  "data": [
    {
      "follower_count": 0,
      "id": "1454155907651158017",
      "name": "테스트 목록",
      "owner_id": "2244994945"
    }
  ],
  "includes": {
    "users": [
      {
        "username": "TwitterDev",
        "id": "2244994945",
        "created_at": "2013-12-14T04:35:55.000Z",
        "name": "Twitter Dev",
      }
    ]
  },
  "meta": {
    "result_count": 1
  }
}