- 유용한 도구
- 핵심 개념
가이드
통합 안내서
이 페이지에는 시스템에 Bookmarks 관리 엔드포인트를 통합할 때 알아두어야 할 여러 도구와 핵심 개념에 대한 정보가 포함되어 있습니다. 이 페이지는 다음과 같은 섹션으로 구성되어 있습니다:
이 엔드포인트를 통합하는 데 도움이 될 핵심 개념을 살펴보기 전에 다음 항목에 익숙해지실 것을 권장합니다:
Postman은 엔드포인트를 테스트하는 데 매우 유용한 도구입니다. 각 Postman 요청에는 모든 경로 및 본문 매개변수가 포함되어 있어 사용 가능한 항목을 빠르게 파악할 수 있습니다. Postman 컬렉션에 대해 더 알아보려면 “Using Postman” 페이지를 방문하세요.
원하는 프로그래밍 언어로 이 엔드포인트를 설정하시겠습니까? 시작점으로 활용할 수 있는 다양한 코드 샘플을 저희 GitHub 페이지에서 확인하실 수 있습니다.
시작에 도움이 될 수 있도록 커뮤니티의 서드파티 라이브러리를 활용하세요. 적절한 버전 태그를 확인하면 v2 엔드포인트와 호환되는 라이브러리를 찾을 수 있습니다.
모든 X API v2 엔드포인트는 요청을 인증하기 위해 일명 키와 토큰으로 불리는 자격 증명 세트를 사용해야 합니다.
다음 엔드포인트는 OAuth 2.0 Authorization Code Flow with PKCE를 반드시 사용해야 하며, 이는 요청을 성공적으로 수행하려면 키와 사용자 액세스 토큰 세트를 사용해야 함을 의미합니다. 액세스 토큰은 여러분이 대리하여 요청하는 사용자와 연결되어 있어야 합니다. 다른 사용자의 액세스 토큰 세트를 생성하려면, 해당 사용자가 Authorize URL을 통해 여러분의 앱을 승인하거나 인증해야 합니다.
OAuth 2.0은 사용하기 까다로울 수 있습니다. 이 인증 방식에 익숙하지 않다면, 라이브러리나 Postman과 같은 도구를 사용해 요청을 올바르게 인증할 것을 권장합니다.
X API v2 엔드포인트에서 사용할 인증 자격 증명 세트를 얻으려면 개발자 계정을 보유하고, 해당 계정 내에 프로젝트를 설정한 뒤 그 프로젝트 내에 Developer 앱을 생성해야 합니다. 그런 다음 Developer 앱에서 키와 토큰을 확인할 수 있습니다.
매일 수많은 개발자들이 X API에 요청을 보냅니다. 이러한 요청의 방대한 양을 관리하기 위해 각 엔드포인트에는 요청 한도가 설정되어 있으며, 이는 앱 또는 인증된 사용자를 대신해 보낼 수 있는 요청 수를 제한합니다.
이러한 엔드포인트는 사용자 수준으로 한도가 적용됩니다. 즉, 사용자를 대신해 요청을 보낼 때 해당 인증된 사용자는 어떤 Developer 앱을 사용하더라도 해당 엔드포인트를 정해진 횟수만 호출할 수 있습니다. GET 메서드의 경우 15분당 사용자 요청 한도는 180건입니다. 북마크 조회 엔드포인트의 GET 메서드를 사용하면 가장 최근에 북마크한 게시물 최대 800개가 반환됩니다. 또한 POST 및 DELETE 메서드의 경우 15분당 사용자 요청 한도는 50건입니다.