- 유용한 도구
- 핵심 개념
- 인증
- 개발자 포털, 프로젝트, 앱
- 요청 한도
유용한 도구
Postman
코드 샘플
서드파티 라이브러리
핵심 개념
인증
개발자 포털, 프로젝트, 그리고 Developer 앱
요청 한도
| 엔드포인트 | HTTP 메서드 | 요청 한도 |
| /2/lists | POST | 15분당 300회 요청 |
| /2/lists/:id | DELETE / PUT | 15분당 300회 요청 |
가이드
통합 안내서
이 페이지에는 Lists 엔드포인트를 시스템에 통합할 때 알아두어야 할 여러 도구와 핵심 개념에 대한 정보가 담겨 있습니다. 이 페이지는 다음과 같은 섹션으로 구성되어 있습니다:
이 엔드포인트 통합에 도움이 될 핵심 개념을 살펴보기 전에, 다음에 익숙해지실 것을 권장합니다:
Postman은 엔드포인트를 테스트하는 데 유용한 도구입니다. 각 Postman 요청에는 사용 가능한 항목을 빠르게 파악할 수 있도록 모든 경로 및 본문 매개변수가 포함되어 있습니다. Postman 컬렉션에 대해 자세히 알아보려면 “Using Postman” 페이지를 방문하세요.
선호하는 프로그래밍 언어로 이 엔드포인트를 설정하는 데 도움이 되는 코드가 필요하신가요? 시작점으로 활용할 수 있는 다양한 코드 샘플을 저희 GitHub 페이지에서 확인하실 수 있습니다.
커뮤니티가 제공하는 서드파티 라이브러리를 활용해 시작해 보세요. 올바른 버전 태그를 확인하면 v2 엔드포인트와 호환되는 라이브러리를 찾을 수 있습니다.
모든 X API v2 엔드포인트는 요청을 인증하기 위해 자격 증명(키와 토큰)을 사용해야 합니다.
다음 엔드포인트는 OAuth 1.0a 사용자 컨텍스트를 사용해야 합니다. 즉, 요청이 성공하려면 API 키와 사용자 액세스 토큰을 사용해야 합니다. 액세스 토큰은 요청을 수행하려는 대상 사용자와 연계되어 있어야 합니다. 다른 사용자의 액세스 토큰을 발급받으려면, 해당 사용자가 3-legged OAuth 플로우를 통해 귀하의 앱을 승인(또는 인증)해야 합니다.
OAuth 1.0a는 다소 까다로울 수 있습니다. 이 인증 방식에 익숙하지 않다면, 라이브러리나 Postman과 같은 도구를 사용해 요청을 올바르게 인증하시는 것을 권장합니다.
X API v2 엔드포인트와 함께 사용할 인증 자격 증명 세트를 받으려면 먼저 개발자 계정에 가입하고, 해당 계정 내에 Project를 설정한 뒤, 그 Project 내에 developer App을 생성해야 합니다. 그런 다음 Developer 앱에서 키와 토큰을 확인할 수 있습니다.
매일 수많은 개발자들이 X API에 요청을 보냅니다. 이러한 대량의 요청을 관리하기 위해 각 엔드포인트에는 요청 한도가 적용되며, 이는 앱 또는 인증된 사용자를 대신해 보낼 수 있는 요청 수를 제한합니다.
이 엔드포인트들은 사용자 수준으로 한도가 적용됩니다. 즉, 어떤 Developer 앱을 사용하든 요청을 대신 수행하는 인증된 사용자는 해당 엔드포인트를 특정 횟수까지만 호출할 수 있습니다.
아래 표는 각 엔드포인트의 요청 한도를 보여줍니다.