소개
프로젝트와 X API 액세스 수준
- Free
- Basic
- Pro
- Free
Free
- PKCE를 사용하는 OAuth 2.0
- 앱 전용
기본
프로젝트
Project는 X API 사용 목적에 따라 작업을 구성하여 API 액세스를 효과적으로 관리하고 사용량을 모니터링할 수 있도록 합니다. 각 Project에는 액세스 수준(이 페이지에서 이후에 설명됨)에 따라 하나 이상의 App을 포함할 수 있습니다. 이러한 App을 사용하여 인증 자격 증명인 API Key와 Secret, 사용자 액세스 토큰, 그리고 앱 액세스 토큰을 생성합니다.
이러한 키와 토큰은 어떤 App에서든 X API 또는 X Ads API에 액세스하는 데 사용할 수 있지만(Ads API를 사용하려면 추가 액세스 신청이 필요함), X API v2 엔드포인트를 사용하려면 Project와 연결된 App의 키와 토큰을 사용해야 합니다.
개발자 계정이 있는 경우 개발자 포털의 Projects & Apps 페이지에서 Project를 확인하고 관리할 수 있습니다. 아직 계정이 없다면 가입하세요.
현재 프로젝트 단위로 적용되는 액세스 티어는 다음의 4가지입니다:
이 액세스 티어는 개발자 계정에 등록한 모든 사용자에게 제공됩니다.
해당 Project 내 App 수: 1
게시물 소비 한도: 월 1,500개 게시물
인증 방법:
이 액세스 계층은 개발자 포털에서 Basic 액세스를 구독한 모든 사용자에게 제공됩니다.
해당 프로젝트 내 앱 수: 2
게시물 소비 한도: 월 10,000개 게시물
인증 방식:
이 액세스 티어는 개발자 포털에서 Pro 액세스를 구독한 모든 사용자에게 제공됩니다.
해당 프로젝트 내 앱 수: 3
게시물 사용 한도: 월 100만 개 게시물
인증 방식:
이 액세스 티어는 Enterprise에 신청하여 우리 팀의 승인을 받고 X 계정 매니저를 통해 월간 자동 갱신 계약에 서명한 분께 제공됩니다. 여기에서 신청하세요.
해당 프로젝트의 앱 수: 3개 이상
게시물 소비 한도: 월 5천만 개 이상 게시물
인증 방법:
트윗 소비 한도는 프로젝트 단위로 적용되며, 특정 X API v2 엔드포인트에서 월별로 가져올 수 있는 트윗 수를 제한합니다.
트윗 한도에 대해 자세히 알아보세요.
프로젝트를 생성하려면 dashboard에서 “New Project”를 클릭하거나 개발자 포털의 Projects & Apps 페이지로 이동하세요. 아직 프로젝트를 만들지 않았다면 해당 옵션이 표시됩니다. 프로젝트 이름, 설명, 사용 사례를 입력하라는 안내가 표시됩니다. 또한 새 앱을 만들거나 기존 독립 실행형 앱을 연결하라는 요청을 받게 됩니다.
프로젝트에 앱이 없다면 대시보드에서 프로젝트 이름을 클릭해 추가할 수 있습니다. 그다음 새 앱을 만들거나 기존 독립형 앱을 선택해 프로젝트에 연결할 수 있습니다. 앱에서는 이 가이드 앞부분에 나열된 인증 키와 토큰을 생성할 수 있습니다.
프로젝트를 편집하려면 개발자 포털의 대시보드 또는 Projects & Apps 페이지에서 프로젝트 이름을 클릭하세요. 그러면 프로젝트 상세 정보가 표시되며, 변경하려면 “편집”을 선택하면 됩니다.
독립형 앱은 Project 구조 밖에 존재하는 앱입니다. 이러한 독립형 앱에 연결된 인증 자격 증명으로 X의 API의 Standard v1.1, Premium v1.1, Enterprise 또는 X Ads API에 성공적으로 요청할 수 있습니다. 독립형 앱은 Project에 연결하지 않으면 X API v2 엔드포인트에 요청할 때 실패합니다.
2020년 8월 이전에 앱을 생성했다면 개발자 포털의 Projects & Apps 아래 “Standalone Apps” 섹션에서 볼 수 있습니다. Project에 연결된 앱을 포함하여 전체 합계가 최대 10개의 앱으로 제한됩니다.
팀 계정의 일부인 경우 Standalone Apps 아래에서 본인이 소유한 앱을 볼 수 있습니다. 팀원이 Project의 일부인 앱을 소유하고 있다면 해당 앱의 이름과 소유자 정보를 볼 수는 있지만 설정을 변경하거나 키와 토큰에 액세스하거나 키와 토큰을 재생성할 수는 없습니다. 해당 앱에 변경이 필요하면 앱 소유자에게 연락해야 합니다.