메인 콘텐츠로 건너뛰기
세 단계로 X API를 시작할 수 있습니다: 가입하고, App을 만들고, 인증 정보를 저장하세요.

​
1단계: 개발자 계정 만들기

1

개발자 콘솔로 이동

console.x.com에 접속하여 X 계정으로 로그인하세요.
2

Developer Agreement 동의

Developer Agreement 및 정책(Policy)을 검토하고 동의하세요.
3

프로필 완료

API를 어떻게 사용할 예정인지에 대한 기본 정보를 제공하세요.

​
2단계: 앱 생성

가입을 마친 후, API 자격 증명을 발급받기 위해 앱을 생성합니다:
1

'New App'을 클릭

개발자 콘솔 대시보드에서 새 앱을 생성합니다.
2

앱 세부 정보 입력

앱의 이름, 설명, 사용 사례를 입력합니다.
3

자격 증명 생성

개발자 콘솔이 API 키와 토큰을 생성합니다.

​
3단계: 자격 증명 저장하기

인증 방식에 따라 여러 개의 자격 증명을 받게 됩니다:
자격 증명 (Credential)용도 (Purpose)
API Key & SecretApp을 식별합니다. 토큰을 생성하고 OAuth 1.0a 요청에 서명하는 데 사용됩니다.
Bearer Token공개 데이터를 읽기 위한 App 전용 인증입니다.
Access Token & Secret자신의 계정(OAuth 1.0a)을 대신하여 요청을 보낼 때 사용합니다.
Client ID & Secret사용자 컨텍스트 기반 요청을 위한 OAuth 2.0 인증에 사용됩니다.
즉시 저장하세요. 자격 증명은 한 번만 표시됩니다. 비밀번호 관리자 또는 보안 금고에 보관하세요. 분실한 경우 다시 생성해야 하며, 이때 이전 자격 증명은 무효화됩니다.

​
어떤 자격 증명이 필요하나요?

공개 데이터에 단순 읽기 전용으로 액세스하려면 Bearer 토큰을 사용하세요.
curl "https://api.x.com/2/users/by/username/xdevelopers" \
  -H "Authorization: Bearer $BEARER_TOKEN"
주 사용 사례: 포스트 검색, 사용자 조회, 트렌드 읽기.

​
자격 증명 보안 모범 사례

환경 변수 사용

소스 코드에 자격 증명을 하드코딩하지 마세요.

Git에 커밋하지 않기

자격 증명 파일을 .gitignore에 추가하세요.

정기적으로 교체

보안 조치로 주기적으로 자격 증명을 재발급하세요.

최소 범위 사용

App에 필요한 OAuth 권한만 요청하세요.

​
다음 단계

첫 번째 요청 보내기

새 자격 증명으로 API를 호출하세요.

인증에 대해 알아보기

OAuth 1.0a와 OAuth 2.0에 대해 이해하세요.