유용한 도구
이 엔드포인트를 통합하는 데 도움이 되는 몇 가지 핵심 개념을 다루기 전에 다음 항목에 익숙해지실 것을 권장합니다:Postman
Postman은 엔드포인트를 테스트하는 데 사용할 수 있는 훌륭한 도구입니다. 각 Postman 요청에는 사용 가능한 모든 항목을 빠르게 이해할 수 있도록 모든 경로와 본문 매개변수가 포함되어 있습니다. Postman 컬렉션에 대해 자세히 알아보려면 “Postman 사용” 페이지를 참조하세요.코드 샘플
원하는 코딩 언어로 이 엔드포인트를 사용하기 시작하는 데 관심이 있으신가요? Github 페이지에서 시작점으로 활용할 수 있는 다양한 코드 샘플을 제공합니다.서드파티 라이브러리
시작하는 데 도움이 되는 커뮤니티의 서드파티 라이브러리 중 하나를 활용하세요. 올바른 버전 태그를 찾아 v2 엔드포인트에서 동작하는 라이브러리를 찾을 수 있습니다.핵심 개념
인증
모든 X API v2 엔드포인트는 자격 증명(key와 token이라고도 함) 세트로 요청을 인증해야 합니다. 이 엔드포인트에서는 OAuth 1.0a User Context를 사용하여 요청을 인증할 수 있습니다. 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을 보여줍니다.필드 및 확장
X API v2 GET 엔드포인트에서는fields 및 expansions라는 도구 세트를 사용하여 API에서 반환할 데이터를 정확히 선택할 수 있습니다. expansions 매개변수를 사용하면 페이로드에서 참조되는 객체를 확장할 수 있습니다. 예를 들어, 고정된 List를 조회할 때 다음 expansion을 가져올 수 있습니다:
owner_id
fields 매개변수를 사용하면 다양한 데이터 객체 내에서 수신할 fields를 정확히 선택할 수 있습니다. 이 엔드포인트는 주로 user 객체를 제공합니다. 기본적으로 List 객체는 id와 name 필드를 반환합니다. list.created_at 또는 list.description과 같은 추가 필드를 수신하려면 fields 매개변수를 사용하여 명시적으로 요청해야 합니다.
X API v2 데이터 사전에 fields 및 expansions를 함께 사용하는 방법에 대한 가이드를 추가했습니다.
아래 표는 lookup 엔드포인트에 대해 사용 가능한 필드 및 expansion을 보여줍니다: