메인 콘텐츠로 건너뛰기

고정 목록 엔드포인트 그룹 시작하기

이 간단한 개요는 Postman을 사용해 고정 목록 엔드포인트에 첫 요청을 보내는 데 도움이 됩니다. 다양한 언어의 샘플 코드를 확인하려면 X API v2 샘플 코드 GitHub 리포지토리를 방문하세요.

사전 준비 사항

이 가이드를 완료하려면 요청 인증에 사용할 키와 토큰 세트가 필요합니다. 다음 단계를 따라 키와 토큰을 생성하세요:
  • 개발자 계정에 등록하고 승인을 받습니다.
  • 개발자 포털에서 Project와 연결된 Developer 앱을 생성합니다.
  • App의 “Keys and tokens” 페이지로 이동해 필요한 자격 증명을 생성합니다. 모든 자격 증명은 안전한 위치에 보관하세요.
X API v2 Postman 컬렉션 불러오기 워크스페이스에 X API v2 Postman 컬렉션을 불러오려면 아래 버튼을 클릭하세요:  

요청 인증

lookup 엔드포인트에 성공적으로 요청하려면 OAuth 1.0a 사용자 컨텍스트, OAuth 2.0 App-Only, 또는 OAuth 2.0 Authorization Code with PKCE를 사용할 수 있습니다. 반면, manage 엔드포인트는 OAuth 1.0a 사용자 컨텍스트 또는 OAuth 2.0 Authorization Code with PKCE로만 인증할 수 있습니다. Postman을 사용하는 경우, 환경을 올바르게 설정했다면 기본 인증 키와 토큰이 요청에 자동으로 채워집니다. Postman의 오른쪽 상단에서 “X API v2”라는 이름의 환경을 선택한 뒤, 환경 드롭다운 옆 눈 아이콘을 클릭하여 “initial value” 및 “current value” 필드에 키와 토큰을 입력하세요. 포함해야 할 키는 다음과 같습니다:
  • API 키(Consumer Key라고도 함)
  • API 시크릿 키(Consumer Secret이라고도 함)
  • OAuth 1.0a 사용자 액세스 토큰
  • OAuth 1.0a 사용자 액세스 토큰 시크릿
  • OAuth 2.0 앱 액세스 토큰
  • OAuth 2.0 클라이언트 키(앱 설정에서 OAuth 2.0 사용자 인증 설정을 구성한 경우에만 제공)
  • OAuth 2.0 클라이언트 시크릿(앱 설정에서 OAuth 2.0 사용자 인증 설정을 구성한 경우에만 제공)