주요 리소스

핵심 문서, 도구 및 커뮤니티 리소스

X API 개발에 꼭 필요한 주요 리소스를 즐겨찾기에 추가해 두세요.

---

​

문서

API 참조 문서

매개변수와 예제가 포함된 엔드포인트 전체 문서.

데이터 사전

게시물, 사용자, 미디어 등 다양한 객체 스키마.

인증

OAuth 1.0a 및 OAuth 2.0 구현 가이드.

요청 한도

엔드포인트별 요청 한도와 모범 사례.

---

​

도구

도구	설명
Developer Console	App, 자격 증명 및 결제를 관리합니다
Postman Collection	대화형 API 테스트
Python SDK	공식 Python 라이브러리
TypeScript SDK	공식 TypeScript 라이브러리
OpenAPI Spec	기계가 읽을 수 있는 API 명세

---

​

학습

튜토리얼

일반적인 사용 사례를 위한 단계별 가이드입니다.

샘플 코드

예제 App 및 코드 샘플을 제공합니다.

무엇을 만들어야 할까요

프로젝트를 위한 아이디어와 영감을 제공합니다.

마이그레이션 가이드

v1.1에서 v2로 업그레이드하는 방법을 안내합니다.

---

​

커뮤니티 & 지원

Developer Forum

커뮤니티에 질문하고 해결 방법을 공유하세요.

Support Hub

FAQ, 문제 해결 가이드, 문의 채널을 확인하세요.

@XDevelopers

공식 업데이트와 공지사항을 확인하세요.

@API

API 관련 소식과 팁을 확인하세요.

---

​

최신 소식 받아보기

Resource	제공 내용
Changelog	모든 플랫폼 변경 사항과 업데이트
Newsletter	플랫폼 소식과 기능 업데이트를 매달 정리한 뉴스레터
Forum Announcements	중요한 플랫폼 공지사항
API Status	실시간 서비스 가용성 정보

중요 변경 사항과 신규 기능을 놓치지 않으려면 @XDevelopers를 팔로우하고 알림을 켜 두세요.

---

​

빠른 참고

​

응답 구조

모든 v2 응답은 다음과 같은 구조를 가집니다:

{
  "data": { ... },      // 기본 객체
  "includes": { ... },  // 확장된 객체(요청 시)
  "meta": { ... },      // 페이지네이션 정보
  "errors": [ ... ]     // 부분 오류(있는 경우)
}

​

공통 매개변수

매개변수	용도
tweet.fields	특정 게시물 필드를 요청
user.fields	특정 사용자 필드를 요청
expansions	관련 객체를 포함
max_results	페이지당 결과 수를 제한
pagination_token	다음/이전 페이지를 가져오기

​

인증 방식

방식	사용 사례
Bearer 토큰	읽기 전용 공개 데이터
OAuth 2.0	세분화된 권한 범위의 사용자 작업
OAuth 1.0a	사용자 작업 (레거시, 전체 권한)

전체 인증 가이드 →