가이드
통합 가이드
이 페이지에는 시스템에 게시물 엔드포인트를 통합할 때 알아두어야 할 여러 도구와 핵심 개념에 대한 정보가 담겨 있습니다. 이 페이지는 몇 가지 섹션으로 구성되어 있습니다:
이 엔드포인트를 통합하는 데 도움이 될 핵심 개념을 살펴보기 전에 다음 항목에 먼저 익숙해지시길 권장합니다:
Postman은 엔드포인트를 테스트하는 데 유용한 도구입니다. 각 Postman 요청에는 모든 경로 및 본문 매개변수가 포함되어 있어 어떤 기능을 사용할 수 있는지 빠르게 파악하는 데 도움이 됩니다. Postman 컬렉션에 대해 자세히 알아보려면 “Postman 사용하기” 페이지를 방문하세요.
선호하는 프로그래밍 언어로 이 엔드포인트를 설정하고 싶으신가요? 시작점으로 활용할 수 있는 다양한 코드 샘플을 저희 GitHub 페이지에서 확인하실 수 있습니다.
커뮤니티가 제공하는 서드파티 라이브러리를 활용해 시작해 보세요. 해당 버전 태그를 확인하면 v2 엔드포인트와 호환되는 라이브러리를 찾을 수 있습니다.
모든 X API v2 엔드포인트는 요청을 인증하기 위해 자격 증명(‘키와 토큰’) 세트를 필요로 합니다.
다음 엔드포인트는 OAuth 1.0a 사용자 컨텍스트를 사용해야 하며, 이는 성공적인 요청을 위해 API 키와 사용자 액세스 토큰 세트를 사용해야 함을 의미합니다. 액세스 토큰은 여러분이 대신 요청을 수행하려는 해당 사용자와 연결되어 있어야 합니다. 다른 사용자의 액세스 토큰 세트를 생성하려면, 해당 사용자가 3-legged OAuth 플로우를 통해 여러분의 App을 승인(또는 인증)해야 합니다.
OAuth 1.0a는 사용하기 까다로울 수 있습니다. 이 인증 방식에 익숙하지 않다면 라이브러리를 사용하거나 Postman과 같은 도구를 활용하거나, OAuth 2.0으로 요청을 인증할 것을 권장합니다.
OAuth 2.0 Authorization Code with PKCE는 애플리케이션의 스코프에 대한 더 세밀한 제어와 여러 기기에 걸친 인가 플로우를 제공합니다. OAuth 2.0은 사용자 대신 특정 권한을 부여하는 세분화된 스코프를 선택할 수 있게 해줍니다.
App에서 OAuth 2.0을 사용하려면, 개발자 포털의 App 설정 섹션에 있는 인증 설정에서 이를 활성화해야 합니다.
X API v2 엔드포인트에서 사용할 인증 자격 증명을 받으려면 개발자 계정이 있어야 하며, 해당 계정 내에 프로젝트를 설정하고 그 프로젝트 안에 Developer 앱을 생성해야 합니다. 그런 다음 Developer 앱에서 키와 토큰을 확인할 수 있습니다.
매일 수많은 개발자들이 X API에 요청을 보냅니다. 이러한 대량의 요청을 관리하기 위해 각 엔드포인트에는 요청 한도가 적용되어, 앱 또는 인증된 사용자를 대신해 보낼 수 있는 요청 수가 제한됩니다.
이 엔드포인트들은 사용자 수준으로 한도가 적용되며, 이는 여러분이 요청을 보내는 대상인 인증된 사용자가 어떤 Developer 앱을 사용하더라도 해당 엔드포인트를 호출할 수 있는 횟수가 제한됨을 의미합니다. POST 메서드의 사용자 요청 한도는 15분당 200회입니다. DELETE 메서드는 15분당 50회의 요청 한도가 있습니다. 또한 manage Posts 또는 manage Retweets 권한으로 생성된 게시물을 포함하여 3시간당 300회 요청 제한이 적용됩니다.
앱 이름과 웹사이트 URL은 애플리케이션이 프로그래밍 방식으로 생성한 모든 게시물의 메타데이터에서 소스 레이블로 표시됩니다. X 앱의 사용 사례가 변경되면 개발자 약관을 준수할 수 있도록 이 설정에서 사용 사례를 반드시 업데이트하세요.
프로필 설정에서 위치 정보(geo)를 활성화한 경우에만 게시물에 위치를 추가할 수 있습니다. 위치 정보가 비활성화되어 있어도 요청 본문에 위치 파라미터를 넣을 수는 있지만, 해당 위치는 게시물에 연결되지 않습니다. 이미지에서 사용자를 태그하는 경우에도 동일합니다. 태그 대상 사용자가 사진 태그 허용을 활성화하지 않았다면, 게시물이 정상적으로 생성되더라도 태그된 사용자 목록에 그들의 이름은 표시되지 않습니다.
현재 X API v2만으로는 미디어를 완전히 업로드할 수 있는 방법이 없습니다. 다만, 이전에 업로드된 미디어를 게시물에 첨부할 수는 있습니다. 이미 v1 미디어 엔드포인트를 사용해 업로드한 미디어나 X Media Studio를 통해 업로드한 미디어의 media id를 사용할 수 있습니다. 이러한 media id는 본인 또는 인증된 사용자의 것이어야 합니다.
다음 단계
API 참조