유용한 도구
이 엔드포인트를 통합하는 데 도움이 되는 몇 가지 핵심 개념을 다루기 전에 다음 항목에 익숙해지실 것을 권장합니다:Postman
Postman은 엔드포인트를 테스트하는 데 사용할 수 있는 훌륭한 도구입니다. 각 Postman 요청에는 사용 가능한 모든 항목을 빠르게 이해할 수 있도록 모든 경로와 본문 매개변수가 포함되어 있습니다. Postman 컬렉션에 대해 자세히 알아보려면 “Postman 사용” 페이지를 참조하세요.코드 샘플
원하는 코딩 언어로 이 엔드포인트를 사용하기 시작하는 데 관심이 있으신가요? Github 페이지에서 시작점으로 활용할 수 있는 다양한 코드 샘플을 제공합니다.서드파티 라이브러리
시작하는 데 도움이 되는 커뮤니티의 서드파티 라이브러리 중 하나를 활용하세요. 올바른 버전 태그를 찾아 v2 엔드포인트에서 동작하는 라이브러리를 찾을 수 있습니다.핵심 개념
인증
모든 X API v2 엔드포인트는 자격 증명(key와 token이라고도 함) 세트로 요청을 인증해야 합니다. 이 특정 엔드포인트는 OAuth 1.0a User Context를 사용해야 합니다. 즉, API key 세트와 사용자 Access Token을 사용하여 성공적으로 요청해야 합니다. Access Token은 대신 요청하려는 사용자와 연결되어 있어야 합니다. 다른 사용자를 위해 Access Token 세트를 생성하려면 해당 사용자가 3-legged OAuth 흐름을 사용하여 App을 인가하거나 인증해야 합니다. OAuth 1.0a는 사용하기 까다로울 수 있습니다. 이 인증 방식에 익숙하지 않은 경우 라이브러리나 Postman과 같은 도구를 사용하여 요청을 올바르게 인증하시길 권장합니다.Developer Console, Project 및 developer App
X API v2 엔드포인트에서 동작하는 인증 자격 증명 세트를 검색하려면 developer account에 가입하고, 해당 계정 내에 Project를 설정한 후, 해당 Project 내에 developer App을 만들어야 합니다. 그런 다음 developer App 내에서 key와 token을 찾을 수 있습니다.Rate limit
매일 수천 명의 개발자가 X API에 요청을 보냅니다. 이러한 요청의 방대한 양을 관리하는 데 도움이 되도록, 각 엔드포인트에는 App 또는 인증된 사용자를 대신하여 요청할 수 있는 횟수를 제한하는 rate limit이 설정되어 있습니다. 이러한 엔드포인트는 사용자 수준에서 rate limit이 적용됩니다. 즉, 요청을 대신 보내는 인증된 사용자가 어떤 developer App에서도 특정 횟수만큼만 엔드포인트를 호출할 수 있음을 의미합니다. 아래 표는 각 엔드포인트의 rate limit을 보여줍니다.코드 예제
List 생성
cURL
List 업데이트
cURL