시작하기

​

List 관리 엔드포인트 그룹 시작하기

이 간단한 개요는 Postman을 사용해 List 관리 엔드포인트에 첫 요청을 보내는 데 도움이 됩니다.

여러 언어의 샘플 코드를 보고 싶다면 GitHub 리포지토리인 X API v2 샘플 코드를 방문하세요.

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

사전 준비 사항

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

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

​

목록 관리 요청을 구성하는 단계

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

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

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

Add X API v2 to Postman

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

2단계: 요청 인증하기

X API에 올바르게 요청하려면 권한이 있는지 확인해야 합니다. 목록 관리 엔드포인트로 이를 수행하려면 OAuth 1.0a User Context 또는 OAuth 2.0 Authorization Code with PKCE를 사용해 요청을 인증해야 합니다.

이 예제에서는 OAuth 1.0a User Context를 사용합니다.

Postman에 키와 토큰(특히 API Key, API Secret Key, OAuth 1.0a 사용자 Access Token, OAuth 1.0a 사용자 Access Token Secret)을 추가해야 합니다. Postman 오른쪽 상단에서 “X API v2”라는 이름의 환경을 선택한 다음, 환경 드롭다운 옆 눈 아이콘을 클릭해 “initial value” 및 “current value” 필드에 키와 토큰을 추가하세요.

올바르게 설정했다면 이러한 변수는 요청의 Authorization 탭에 자동으로 반영됩니다.   3단계: 새 목록의 이름 지정하기

이 엔드포인트로 새 목록을 만들 때 목록 이름은 필수 본문 매개변수입니다. 선택적으로 설명을 제공하고 목록을 비공개로 설정할 수 있습니다.

Postman에서 “Body” 탭으로 이동해 name 매개변수의 값으로 목록의 이름을 입력하세요. 또한 목록 설명을 추가하려면 name과 동일한 방식으로 description이라는 새 키를 추가하고 값으로 목록 설명을 입력하면 됩니다. 목록을 비공개로 설정하는 것도 동일한 패턴을 따르며, 이 매개변수에는 true 또는 false 값만 허용됩니다. 

Key	Value	Parameter type
name	목록의 이름(필수)	body
description	목록 설명(선택)	body
private	true 또는 false(선택)	body

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

https://api.x.com/2/lists

4단계: 요청 보내기 및 응답 확인

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

{
  "data": {
    "id": "1441162269824405510",
    "name": "Postman에서 생성된 새 리스트"
  }
}

반환된 응답 객체에 id와 목록 이름이 포함되어 있다면, 목록이 성공적으로 생성된 것입니다. 

목록을 삭제하려면 Postman에 로드된 X API v2 컬렉션의 “Lists” 폴더에 있는 “Delete a List” 요청을 선택하세요. 이 엔드포인트는 삭제하려는 목록의 ID가 필요합니다. “Params” 탭에서 삭제하려는 목록의 ID를 id 열의 값으로 입력하세요. 

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

{
  "data": {
    "deleted": true
  }
}