연동 가이드

이 페이지에서는 manage Posts 엔드포인트를 시스템에 통합하기 위한 도구와 핵심 개념을 다룹니다.

유용한 도구

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

Postman

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

코드 샘플

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

서드파티 라이브러리

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

핵심 개념

인증

모든 X API v2 엔드포인트는 요청을 인증하기 위해 일련의 자격 증명(키와 토큰이라고도 함)이 필요합니다. 이 엔드포인트들은 OAuth 1.0a User Context를 사용해야 하며, 이는 요청을 성공적으로 수행하려면 API 키와 사용자 액세스 토큰(Access Token) 세트를 사용해야 함을 의미합니다. 액세스 토큰은 요청을 대신 수행하려는 사용자와 연결되어 있어야 합니다. 다른 사용자의 액세스 토큰 세트를 생성하려면, 해당 사용자가 3-legged OAuth flow를 사용하여 귀하의 App을 승인(Authorization)하거나 인증(Authentication)해야 합니다. OAuth 1.0a는 사용하기 까다로울 수 있습니다. 이 인증 방식에 익숙하지 않다면, 라이브러리를 사용하거나 Postman과 같은 도구를 사용하거나, OAuth 2.0을 사용하여 요청을 인증할 것을 권장합니다. OAuth 2.0 Authorization Code with PKCE는 애플리케이션의 범위(scope)와 여러 기기에 걸친 인가 플로우에 대해 더 높은 수준의 제어를 제공합니다. OAuth 2.0을 사용하면 사용자 권한을 대신해 세밀하게 구분된 scope를 선택하여 특정 권한만을 부여할 수 있습니다. App에서 OAuth 2.0을 사용하려면, 개발자 콘솔의 App 설정 섹션에 있는 App의 인증 설정에서 OAuth 2.0을 활성화해야 합니다.

개발자 콘솔, 프로젝트, 그리고 개발자 App

X API v2 엔드포인트에서 사용할 인증 자격 증명 세트를 발급받으려면 개발자 계정을 보유하고, 해당 계정 내에 프로젝트를 설정한 뒤, 그 프로젝트 안에 개발자 App을 생성해야 합니다. 그런 다음 해당 개발자 App에서 키와 토큰을 확인할 수 있습니다.

요청 한도

매일 수많은 개발자들이 X API에 요청을 보냅니다. 이러한 대량의 요청을 관리하기 위해, 요청 한도가 각 엔드포인트에 설정되어 있으며, 이는 App 또는 인증된 사용자를 대신해 보낼 수 있는 요청 수를 제한합니다. 이 엔드포인트들은 사용자 수준에서 요청 한도가 적용됩니다. 즉, 요청을 보내는 데 사용되는 인증된 사용자는 어떤 개발자 App을 사용하더라도 해당 엔드포인트를 호출할 수 있는 횟수가 일정 횟수로 제한됩니다. POST 메서드의 경우 사용자 요청 한도는 15분당 200건입니다. DELETE 메서드는 15분당 50건의 요청 한도가 있습니다. 또한, manage Posts 또는 manage Retweets 권한으로 생성된 포스트를 포함하여 3시간당 300건의 요청 한도가 있습니다.

소스 라벨

App 이름과 웹사이트 URL은 애플리케이션에 의해 프로그래밍 방식으로 생성된 모든 게시물의 메타데이터에서 소스 라벨로 표시됩니다. X App의 사용 사례가 변경되는 경우, Developer Terms를 준수하고 있는지 확인할 수 있도록 반드시 이 설정에서 사용 사례를 업데이트해야 합니다.

프로필 설정

프로필 설정에서 위치 정보(geo) 기능을 활성화한 경우에만 포스트에 위치를 추가할 수 있습니다. 위치 정보 기능을 활성화하지 않았더라도 요청 본문에 위치 파라미터를 포함할 수는 있지만, 해당 위치는 포스트에 첨부되지 않습니다. 이미지에 사용자를 태그하는 경우에도 마찬가지입니다. 태그하려는 사용자가 사진 태그 기능을 활성화하지 않은 경우, 포스트는 성공적으로 생성되더라도 해당 사용자의 이름은 태그된 사용자 목록에 표시되지 않습니다.

게시물에 미디어 추가하기

현재는 X API v2만으로 미디어를 처음부터 업로드하는 방법이 없습니다. 하지만 이미 업로드된 미디어를 게시물에 첨부할 수는 있습니다. v1 media 엔드포인트를 사용해 업로드했거나 X Media Studio를 통해 업로드된 미디어의 media id를 사용할 수 있습니다. 이 media id는 본인의 것이거나 인증된 사용자의 것이어야 합니다.

코드 예제

게시물 생성

cURL

curl -X POST "https://api.x.com/2/tweets" \
  -H "Authorization: OAuth ..." \
  -H "Content-Type: application/json" \
  -d '{"text": "Hello world!"}'

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.posts.create(text="Hello world!")
print(f"Created Post: {response.data.id}")

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.posts.create({ text: "Hello world!" });
console.log(`Created Post: ${response.data?.id}`);

답글 작성하기

cURL

curl -X POST "https://api.x.com/2/tweets" \
  -H "Authorization: OAuth ..." \
  -H "Content-Type: application/json" \
  -d '{"text": "This is a reply!", "reply": {"in_reply_to_tweet_id": "1234567890"}}'

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.posts.create(
    text="This is a reply!",
    reply={"in_reply_to_tweet_id": "1234567890"}
)
print(f"Created reply: {response.data.id}")

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.posts.create({
  text: "This is a reply!",
  reply: { inReplyToTweetId: "1234567890" },
});
console.log(`Created reply: ${response.data?.id}`);

게시물 삭제

cURL

curl -X DELETE "https://api.x.com/2/tweets/1234567890" \
  -H "Authorization: OAuth ..."

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.posts.delete("1234567890")
print(f"Deleted: {response.data.deleted}")

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.posts.delete("1234567890");
console.log(`Deleted: ${response.data?.deleted}`);

다음 단계 API 참조 문서

개요

포스트

사용자

다이렉트 메시지

좋아요

리스트

Spaces

커뮤니티

커뮤니티 노트

트렌드

뉴스

미디어

X 활동

사용량

스트림 연결

규정 준수

Enterprise v2

좋아요 스트림

GNIP 2.0

연동 가이드

유용한 도구

Postman

코드 샘플

서드파티 라이브러리

핵심 개념

인증

개발자 콘솔, 프로젝트, 그리고 개발자 App

요청 한도

소스 라벨

프로필 설정

게시물에 미디어 추가하기

코드 예제

게시물 생성

답글 작성하기

게시물 삭제

​유용한 도구

​Postman

​코드 샘플

​서드파티 라이브러리

​핵심 개념

​인증

​개발자 콘솔, 프로젝트, 그리고 개발자 App

​요청 한도

​소스 라벨

​프로필 설정

​게시물에 미디어 추가하기

​코드 예제

​게시물 생성

​답글 작성하기

​게시물 삭제

유용한 도구

Postman

코드 샘플

서드파티 라이브러리

핵심 개념

인증

개발자 콘솔, 프로젝트, 그리고 개발자 App

요청 한도

소스 라벨

프로필 설정

게시물에 미디어 추가하기

코드 예제

게시물 생성

답글 작성하기

게시물 삭제