고정된 목록 관리

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

​

고정된 리스트 관리 요청을 구성하는 단계

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

Postman에 X API v2 컬렉션을 불러온 후 “List” 폴더로 이동해 “Pinned Lists” 폴더를 선택하고, “Pin a List”를 선택합니다.  

2단계: 고정할 리스트 지정

고정된 리스트 관리 엔드포인트에는 두 개의 ID가 필요합니다. 하나는 사용자(리스트를 고정할 인증된 사용자)용이고, 다른 하나는 대상 리스트(고정될 리스트)용입니다. 사용자 ID는 인증에 사용되는 사용자 ID와 일치해야 하며, 이는 요청을 인증할 때 해당 사용자 ID와 연결된 액세스 토큰을 전달해야 함을 의미합니다. 이 경우 본인 사용자에 속한 ID를 지정하면 됩니다. 본인의 ID는 다음 두 가지 방법으로 찾을 수 있습니다.

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

대상 리스트 ID는 유효한 어떤 리스트라도 가능합니다. Postman에서 “Params” 탭으로 이동하여 id 경로 변수의 “Value” 열에 사용자 ID를 입력합니다. “Body” 탭으로 이동하여 고정하려는 리스트의 ID를 list_id 매개변수의 값으로 입력합니다. 어떤 ID 앞뒤에도 공백이 없도록 하세요.

Key	Value	Parameter type
id	사용자 ID	path
list_id	고정할 대상 리스트 ID	body

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

      https://api.x.com/2/users/2244994945/pinned_lists

3단계: 요청 보내기 및 응답 검토

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

{
  "data": {
    "pinned": true
  }
}

반환된 응답 객체에서 pinned 키의 값이 true이면 대상 목록이 성공적으로 고정된 것입니다. 

목록 고정을 해제하려면 Postman에 로드된 X API v2 컬렉션의 “Lists” 폴더에 있는 “Unpin List” 요청을 선택하세요. 이 엔드포인트에는 인증된 사용자 ID와 고정을 해제할 목록의 ID가 필요합니다. “Params” 탭에서 id 열에는 사용자 ID를, list_id 열에는 고정을 해제할 목록의 ID를 입력하세요. 

삭제 요청이 성공하면 다음 예시와 유사한 응답을 받게 됩니다:

{
  "data": {
    "pinned": false
  }
}