연동 가이드

이 페이지에서는 Lists 엔드포인트와 통합할 때 필요한 도구와 핵심 개념을 다룹니다.

유용한 도구

이 엔드포인트를 통합하는 데 도움이 되는 몇 가지 핵심 개념을 살펴보기 전에, 먼저 다음 도구들에 익숙해질 것을 권장합니다:

Postman

Postman은 엔드포인트를 테스트해 볼 수 있는 유용한 도구입니다. 각 Postman 요청에는 모든 경로 및 본문 매개변수가 포함되어 있어, 사용할 수 있는 내용을 빠르게 파악하는 데 도움이 됩니다. Postman 컬렉션에 대해 자세히 알아보려면 “Postman 사용하기” 페이지를 방문하세요.

코드 샘플

선호하는 프로그래밍 언어로 이 엔드포인트를 설정해 보고 싶으신가요? 시작점으로 활용할 수 있는 다양한 코드 샘플을 GitHub 페이지에서 확인하실 수 있습니다.

서드파티 라이브러리

커뮤니티에서 제공하는 서드파티 라이브러리를 활용해 시작해 보세요. 적절한 버전 태그를 확인해 v2 엔드포인트와 호환되는 라이브러리를 찾을 수 있습니다.

핵심 개념

인증

모든 X API v2 엔드포인트는 키와 토큰이라고도 불리는 자격 증명 세트를 사용하여 요청을 인증해야 합니다. 이 엔드포인트들은 OAuth 1.0a User Context를 사용해야 하며, 이는 요청을 성공적으로 수행하기 위해 API 키와 사용자 Access Token 세트를 사용해야 함을 의미합니다. Access Token은 요청을 대신 수행하려는 사용자와 연관되어 있어야 합니다. 다른 사용자의 Access Token 세트를 생성하려면, 해당 사용자가 3-legged OAuth flow를 통해 사용하는 App을 승인하거나 인증해야 합니다. OAuth 1.0a는 사용하기 까다로울 수 있다는 점에 유의하시기 바랍니다. 이 인증 방식에 익숙하지 않다면, 라이브러리 또는 Postman과 같은 도구를 사용하여 요청을 올바르게 인증할 것을 권장합니다.

개발자 콘솔, Project 및 개발자 App

X API v2 엔드포인트와 함께 사용할 수 있는 인증 자격 증명 세트를 발급받으려면 먼저 개발자 계정에 가입하고, 해당 계정 내에 Project를 설정한 뒤 그 Project 내에 개발자 App을 생성해야 합니다. 이후 개발자 App에서 키와 토큰을 확인할 수 있습니다.

요청 한도

매일 수천 명이 넘는 개발자가 X API에 요청을 보냅니다. 이러한 대규모 요청량을 관리하기 위해 각 엔드포인트에는 요청 한도가 적용되며, 이 한도는 앱 또는 인증된 사용자를 대신해 보낼 수 있는 요청 횟수를 제한합니다. 이 엔드포인트들은 사용자 수준에서 요청 한도가 적용되며, 이는 여러분이 요청을 보내는 대상인 인증된 사용자가 어떤 개발자 App을 사용하더라도 해당 엔드포인트를 호출할 수 있는 횟수가 일정 기준으로 제한된다는 의미입니다. 아래 표는 각 엔드포인트에 대한 요청 한도를 보여 줍니다.


엔드포인트	HTTP 메서드	요청 한도
/2/lists	POST	15분당 300건의 요청
/2/lists/:id	DELETE / PUT	15분당 300건의 요청

코드 예시

리스트 생성하기

cURL

curl -X POST "https://api.x.com/2/lists" \
  -H "Authorization: OAuth ..." \
  -H "Content-Type: application/json" \
  -d '{"name": "My List", "description": "A list of interesting accounts"}'

from xdk import Client
from xdk.oauth1_auth import OAuth1

oauth1 = OAuth1(
    api_key="YOUR_API_KEY",
    api_secret="YOUR_API_SECRET",
    access_token="YOUR_ACCESS_TOKEN",
    access_token_secret="YOUR_ACCESS_TOKEN_SECRET"
)

client = Client(auth=oauth1)

# 새 리스트를 생성합니다
response = client.lists.create(
    name="My List",
    description="A list of interesting accounts"
)
print(response.data)

import { Client, OAuth1 } from "@xdevplatform/xdk";

const oauth1 = new OAuth1({
  apiKey: "YOUR_API_KEY",
  apiSecret: "YOUR_API_SECRET",
  accessToken: "YOUR_ACCESS_TOKEN",
  accessTokenSecret: "YOUR_ACCESS_TOKEN_SECRET",
});

const client = new Client({ oauth1 });

// 새 리스트를 생성합니다
const response = await client.lists.create({
  name: "My List",
  description: "A list of interesting accounts",
});
console.log(response.data);

리스트 업데이트하기

cURL

curl -X PUT "https://api.x.com/2/lists/123456789" \
  -H "Authorization: OAuth ..." \
  -H "Content-Type: application/json" \
  -d '{"name": "Updated List Name"}'

from xdk import Client
from xdk.oauth1_auth import OAuth1

oauth1 = OAuth1(
    api_key="YOUR_API_KEY",
    api_secret="YOUR_API_SECRET",
    access_token="YOUR_ACCESS_TOKEN",
    access_token_secret="YOUR_ACCESS_TOKEN_SECRET"
)

client = Client(auth=oauth1)

# 리스트 업데이트하기
response = client.lists.update(
    list_id="123456789",
    name="Updated List Name"
)
print(response.data)

import { Client, OAuth1 } from "@xdevplatform/xdk";

const oauth1 = new OAuth1({
  apiKey: "YOUR_API_KEY",
  apiSecret: "YOUR_API_SECRET",
  accessToken: "YOUR_ACCESS_TOKEN",
  accessTokenSecret: "YOUR_ACCESS_TOKEN_SECRET",
});

const client = new Client({ oauth1 });

// 리스트 업데이트하기
const response = await client.lists.update("123456789", {
  name: "Updated List Name",
});
console.log(response.data);

개요

포스트

사용자

다이렉트 메시지

좋아요

리스트

Spaces

커뮤니티

커뮤니티 노트

트렌드

뉴스

미디어

X 활동

사용량

스트림 연결

규정 준수

Enterprise v2

좋아요 스트림

GNIP 2.0

연동 가이드

유용한 도구

Postman

코드 샘플

서드파티 라이브러리

핵심 개념

인증

개발자 콘솔, Project 및 개발자 App

요청 한도

코드 예시

리스트 생성하기

리스트 업데이트하기

​유용한 도구

​Postman

​코드 샘플

​서드파티 라이브러리

​핵심 개념

​인증

​개발자 콘솔, Project 및 개발자 App

​요청 한도

​코드 예시

​리스트 생성하기

​리스트 업데이트하기

유용한 도구

Postman

코드 샘플

서드파티 라이브러리

핵심 개념

인증

개발자 콘솔, Project 및 개발자 App

요청 한도

코드 예시

리스트 생성하기

리스트 업데이트하기