메인 콘텐츠로 건너뛰기

1단계: 개발자 계정 가입

개발자 계정 가입은 빠르고 간단합니다! 아래 버튼을 클릭하고 몇 가지 질문에 답하면, Basic access로 X API v2를 탐색하고 활용을 시작할 수 있습니다. 다음으로 온보딩 과정에서 Project와 해당 Project에 연결된 Developer 앱을 생성하게 되며, 이를 통해 API에 대한 모든 요청을 인증하는 데 사용할 자격 증명 세트를 발급받습니다. 가입하기

2단계: 앱의 키와 토큰을 저장하고 안전하게 보호하세요

액세스 권한을 얻고 Project와 App을 생성하면, Developer 앱 내에서 다음 자격 증명을 확인하거나 생성할 수 있습니다:
  • API Key and Secret: 앱의 사용자 이름과 비밀번호에 해당합니다. OAuth 1.0a 사용자 컨텍스트가 필요한 요청을 인증하거나, 사용자 액세스 토큰 또는 앱 액세스 토큰과 같은 다른 토큰을 생성하는 데 사용합니다.
  • Access Token and Secret: 일반적으로 액세스 토큰은 여러분이 대신 요청을 수행하는 사용자를 나타냅니다. 개발자 포털에서 생성하는 토큰은 앱 소유자(해당 사용자)를 나타냅니다. 이는 OAuth 1.0a 사용자 컨텍스트가 필요한 요청을 인증하는 데 사용합니다. 다른 사용자를 대신하여 요청하려면, 해당 사용자가 여러분을 승인할 수 있도록 3-legged OAuth 플로우를 사용해야 합니다.
  • Client ID and Client Secret: 이 자격 증명은 OAuth 2.0 인증으로 사용자 액세스 토큰을 획득하는 데 사용됩니다. OAuth 1.0a와 마찬가지로 사용자 액세스 토큰은 비공개 사용자 계정 정보에 접근하거나 다른 계정을 대신해 작업을 수행하는 요청을 인증하는 데 사용되며, 클라이언트 애플리케이션이 사용자에 대해 갖는 접근 권한을 세밀한 범위로 보다 정교하게 제어할 수 있습니다.
  • App only Access Token: X에서 공개적으로 제공되는 정보로 응답하는 엔드포인트에 요청할 때 이 토큰을 사용합니다.
이 키와 토큰은 재생성하지 않는 한 만료되지 않으므로, 자격 증명을 받은 후에는 비밀번호 관리자와 같은 안전한 위치에 보관하는 것을 권장합니다.
참고: 키와 토큰은 개발자 포털에서 한 번만 표시되므로, 생성 즉시 비밀번호 관리 시스템에 저장하는 것이 중요합니다. 키와 토큰을 분실하거나 잊어버린 경우 재생성해야 하며, 새 자격 증명이 생성되고 이전 것은 무효화됩니다. 이는 이전 자격 증명으로 구성해 둔 모든 통합을 업데이트해야 함을 의미합니다. 인증 모범 사례에 대해 더 알아보세요.

3단계: 첫 요청 보내기

다음은 무엇일까요? 이제 API에 첫 요청을 보내 봅시다! 시작에 도움이 되는 가이드, 튜토리얼, 도구, 코드가 준비되어 있습니다. 아래 페이지가 좋은 출발점이지만, 전체 문서를 탐색하는 데 유용한 주요 리소스 페이지도 함께 마련해 두었으니 참고하세요. 첫 요청 보내기

다음 단계

API 참조 색인을 통해 작업을 시작할 엔드포인트를 찾아보세요. 또한 통합 속도를 높이는 데 활용할 수 있는 X API의 도구와 라이브러리도 제공합니다.