메인 콘텐츠로 건너뛰기

​
인증된 사용자 조회 엔드포인트 시작하기

이 빠른 시작 가이드는 Postman을 사용해 인증된 사용자 조회 엔드포인트에 첫 요청을 보내는 방법을 안내합니다. 여러 언어의 예제 코드를 보고 싶다면 X API v2 샘플 코드 GitHub 리포지토리를 방문하세요.

​
사전 준비 사항

이 가이드를 완료하려면 요청을 인증할 키와 토큰 세트가 필요합니다. 다음 단계를 따라 키와 토큰을 생성할 수 있습니다.
  • 개발자 계정에 가입하고 승인을 받습니다.
  • 개발자 포털에서 Project와 연결된 Developer 앱을 생성합니다.
  • App의 “Keys and tokens” 페이지로 이동해 필요한 자격 증명을 생성합니다. 모든 자격 증명은 안전한 위치에 보관하세요.

​
인증된 사용자 조회 요청을 구성하는 단계

​
1단계: 도구 또는 라이브러리로 시작

이 엔드포인트에 요청을 보내는 데 사용할 수 있는 도구, 코드 예제, 라이브러리가 여러 가지 있지만, 여기서는 과정을 간소화하기 위해 Postman을 사용하겠습니다. X API v2 Postman 컬렉션을 환경에 불러오려면 다음 버튼을 클릭하세요:
Postman에 X API v2 컬렉션을 불러온 후 “Authenticated User Lookup” 폴더로 이동하여 “Lookup an Authenticated User”를 선택하세요.

​
2단계: 요청 인증하기

X API에 요청을 올바르게 보내려면 권한이 있음을 확인해야 합니다. 이 엔드포인트에서는 OAuth 1.0a 사용자 컨텍스트 또는 OAuth 2.0 Authorization Code with PKCE로 요청을 인증해야 합니다. 이 예제에서는 OAuth 1.0a 사용자 컨텍스트를 사용합니다. Postman에 키와 토큰—구체적으로 API Key, API Secret Key, OAuth 1.0a 사용자 액세스 토큰, OAuth 1.0a 사용자 액세스 토큰 시크릿—을 추가해야 합니다. 이를 위해 Postman 우측 상단에서 “X API v2”라는 이름의 환경을 선택하고, 환경 드롭다운 옆 눈 아이콘을 클릭하여 “initial value”와 “current value” 필드에 키와 토큰을 추가하세요. 올바르게 설정했다면 이러한 변수는 요청의 Authorization 탭에 자동으로 적용됩니다.  
3단계: 가져올 사용자 필드를 결정합니다
3단계까지 완료한 뒤 “Send” 버튼을 클릭하면 응답에 기본 user object 필드인 id, name, username이 포함됩니다. id, name, username 외에 추가 필드를 받으려면, 요청에서 field 및/또는 expansion 매개변수로 해당 필드를 지정해야 합니다. 이번 연습에서는 서로 다른 객체에서 다음의 세 가지 추가 필드 집합을 요청합니다:
  1. 기본 사용자 객체의 추가 user.created_at 필드
  2. 반환된 사용자에 연결된 고정 게시물 객체의 기본 필드: id, text
  3. 연결된 게시물 객체의 추가 tweet.created_at 필드
Postman에서 “Params” 탭으로 이동하여 “Query Params” 표에 다음 key:value 쌍을 추가하세요:
KeyValueReturned fields
user.fieldscreated_atuser.created_at
expansionspinned_tweet_idincludes.tweets.id,
includes.tweets.text
tweet.fieldscreated_at, author_idincludes.tweets.created_at, includes_tweets.author_id
이제 “Send” 버튼 옆에 이와 유사한 URL이 표시됩니다: 
      https://api.x.com/2/users/me?user.fields=created_at&expansions=pinned_tweet_id&tweet.fields=author_id,created_at