통합 가이드

이 페이지에는 시스템에 Bookmarks 관리 엔드포인트를 통합할 때 알아 두어야 할 여러 도구와 핵심 개념에 대한 정보가 포함되어 있습니다. 내용을 다음과 같은 섹션으로 나누었습니다:

유용한 도구
핵심 개념
- 인증
- [개발자 콘솔, 프로젝트, App](/x-api/users/blocks/integrate#Developer Console-projects-and-developer-apps)
- 요청 한도

유용한 도구

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

Postman

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

코드 예제

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

서드파티 라이브러리

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

핵심 개념

인증

모든 X API v2 엔드포인트는 키와 토큰으로 구성된 자격 증명 세트를 사용해 요청을 인증해야 합니다. 이 특정 엔드포인트들은 PKCE가 포함된 OAuth 2.0 Authorization Code Flow를 사용해야 하며, 이는 성공적인 요청을 위해 키와 사용자 Access Token 세트를 함께 사용해야 한다는 의미입니다. Access Token은 대신 요청을 보내려는 해당 사용자와 연결되어 있어야 합니다. 다른 사용자를 위한 Access Token 세트를 생성하려면, 그 사용자가 Authorize URL을 통해 귀하의 App을 승인하거나 인증해야 합니다. OAuth 2.0은 사용하기 까다로울 수 있습니다. 이 인증 방식에 익숙하지 않다면, 라이브러리나 Postman과 같은 도구를 사용하여 요청을 올바르게 인증할 것을 권장합니다.

개발자 콘솔, 프로젝트, 개발자 App

X API v2 엔드포인트와 함께 사용할 수 있는 인증 자격 증명 세트를 얻으려면 개발자 계정을 보유하고, 해당 계정 내에 Project를 설정하고, 그 Project 내에 developer App을 생성해야 합니다. 그런 다음 해당 개발자 App 내에서 키와 토큰을 확인할 수 있습니다.

요청 한도

매일 수천 명의 개발자가 X API에 요청을 보냅니다. 이렇게 막대한 수의 요청을 관리하기 위해 각 엔드포인트에는 요청 한도가 설정되어 있으며, 이를 통해 App 또는 인증된 사용자를 대신해 보낼 수 있는 요청 수가 제한됩니다. 이 엔드포인트들은 사용자 단위로 요청이 제한되며, 이는 요청을 수행하는 인증된 사용자가 어떤 개발자 App을 사용하든 해당 엔드포인트를 호출할 수 있는 횟수에 제한이 있다는 의미입니다. GET 메서드의 경우, 사용자 요청 한도는 15분 동안 180회입니다. Bookmarks 조회 엔드포인트의 GET 메서드를 사용하면 가장 최근에 북마크한 포스트 800개를 반환받습니다. 추가로, POST 및 DELETE 메서드의 경우 사용자 요청 한도는 15분 동안 50회입니다.

코드 예제

북마크 가져오기

cURL

curl "https://api.x.com/2/users/123/bookmarks?tweet.fields=created_at,public_metrics" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN"

from xdk import Client

client = Client(bearer_token="YOUR_USER_ACCESS_TOKEN")

# 사용자의 북마크 가져오기
for page in client.bookmarks.get(user_id="123", tweet_fields=["created_at", "public_metrics"]):
    for post in page.data:
        print(f"{post.text} - 좋아요: {post.public_metrics.like_count}")

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

const client = new Client({ accessToken: "YOUR_USER_ACCESS_TOKEN" });

// 사용자의 북마크 가져오기
const paginator = client.bookmarks.get("123", {
  tweetFields: ["created_at", "public_metrics"],
});

for await (const page of paginator) {
  page.data?.forEach((post) => {
    console.log(`${post.text} - 좋아요: ${post.public_metrics?.like_count}`);
  });
}

북마크 생성

cURL

curl -X POST "https://api.x.com/2/users/123/bookmarks" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"tweet_id": "1234567890"}'

from xdk import Client

client = Client(bearer_token="YOUR_USER_ACCESS_TOKEN")

# 게시물을 북마크합니다
response = client.bookmarks.create(user_id="123", tweet_id="1234567890")
print(response.data)

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

const client = new Client({ accessToken: "YOUR_USER_ACCESS_TOKEN" });

// 게시물을 북마크합니다
const response = await client.bookmarks.create("123", { tweetId: "1234567890" });
console.log(response.data);

개요

포스트

사용자

다이렉트 메시지

좋아요

리스트

Spaces

커뮤니티

커뮤니티 노트

트렌드

뉴스

미디어

X 활동

사용량

스트림 연결

규정 준수

Enterprise v2

좋아요 스트림

GNIP 2.0

통합 가이드

유용한 도구

Postman

코드 예제

서드파티 라이브러리

핵심 개념

인증

개발자 콘솔, 프로젝트, 개발자 App

요청 한도

코드 예제

북마크 가져오기

북마크 생성

​유용한 도구

​Postman

​코드 예제

​서드파티 라이브러리

​핵심 개념

​인증

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

​요청 한도

​코드 예제

​북마크 가져오기

​북마크 생성

유용한 도구

Postman

코드 예제

서드파티 라이브러리

핵심 개념

인증

개발자 콘솔, 프로젝트, 개발자 App

요청 한도

코드 예제

북마크 가져오기

북마크 생성