메인 콘텐츠로 건너뛰기

​
Spaces 조회 엔드포인트 시작하기

이 빠른 시작 가이드는 Postman을 사용해 지정한 필드 세트와 함께 Spaces 조회 엔드포인트 중 하나에 첫 요청을 보내는 방법을 안내합니다. 다양한 프로그래밍 언어의 샘플 코드를 확인하려면 X API v2 sample code GitHub 리포지토리를 방문하세요.

​
사전 준비 사항

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

​
Spaces 조회 요청을 구성하는 단계

이 예에서는 작성자 ID 기준의 사용자 Spaces 조회 엔드포인트에 요청을 보내 보겠지만, 이 빠른 시작에서 배운 내용을 다른 조회 요청에도 적용할 수 있습니다. 1단계: 도구 또는 라이브러리로 시작하기 이 엔드포인트에 요청을 보내는 데 사용할 수 있는 도구, 코드 예제, 라이브러리가 여럿 있지만, 여기서는 과정을 단순화하기 위해 Postman을 사용하겠습니다. X API v2 Postman 컬렉션을 환경에 로드하려면 아래 버튼을 클릭하세요:
Postman에 X API v2 컬렉션을 로드한 후 Spaces 폴더로 이동하여 “Lookup Spaces created by one or more users” 요청을 찾습니다.   2단계: 요청 인증하기 X API에 올바르게 요청하려면 권한이 있는지 확인해야 합니다. 이를 위해 이 엔드포인트는 OAuth 2.0 App-Only 또는 OAuth 2.0 Authorization Code with PKCE 인증 방식으로 요청을 인증해야 합니다. 간단히 하기 위해 이 요청에서는 OAuth 2.0 App-Only를 사용하겠지만, 비공개 지표 또는 비공개 사용자의 Spaces를 요청하려면 다른 인증 방식 중 하나를 사용해야 합니다.  OAuth 2.0 App-Only를 사용하려면 키와 토큰, 특히 App Access Token (App-only Bearer Token이라고도 함)을 Postman에 추가해야 합니다. 이를 위해 Postman 오른쪽 상단에서 “X API v2”라는 이름의 환경을 선택하고, 환경 드롭다운 옆의 눈 아이콘을 클릭하여 “initial value” 및 “current value” 필드에 키와 토큰을 추가하세요. 올바르게 설정했다면 이러한 변수는 요청의 Authorization 탭으로 자동으로 가져와집니다.   3단계: 어떤 사용자로부터 게시물을 조회할지 식별하고 지정하기 요청에서 실시간 또는 예정된 Spaces를 조회할 사용자를 지정해야 합니다. 이 예에서는 단일 사용자 ID를 전달합니다. 사용자 ID는 계정 프로필 URL에서 확인할 수 있는 계정 핸들을 나타내는 숫자 값입니다. 예를 들어 다음 계정의 사용자명은 XDevelopers입니다. https://x.com/XDevelopers 이 사용자명을 사용자 ID로 변환하려면 사용자 조회 엔드포인트에서 해당 사용자명을 사용해 페이로드에서 숫자 사용자 ID를 찾으면 됩니다. @XDevelopers의 경우 사용자 ID는 2244994945입니다. Postman에서 “Params” 탭으로 이동하여 id 매개변수의 “Value” 열에 이 사용자 ID를 입력하세요.
KeyValue
id2244994945
4단계: 조회할 필드를 식별하고 지정하기 3단계 이후 “Send” 버튼을 클릭하면 응답에서 기본으로 반환되는 Space object 필드인 id만 받게 됩니다. 추가 필드를 받으려면 요청에 space.fields 또는 expansions 매개변수로 지정해야 합니다. 이 연습에서는 서로 다른 오브젝트에서 세 가지 추가 필드 세트를 요청합니다:
  • 기본 Spaces 오브젝트의 추가 title 필드
  • 지정된 creator ID의 전체 user object
  • 연관된 user 오브젝트의 추가 user.created_at 필드
Postman에서 “Params” 탭으로 이동하여 “Query Params” 표에 다음 key:value 쌍을 추가하세요:
KeyValueReturned fields
space.fieldstitlecreator_id
expansionscreator_idincludes.users.id, includes.users.name, includes.users.username
user.fieldscreated_atincludes.users.created_at
이제 “Send” 버튼 옆에 다음 URL이 표시되어야 합니다: https://api.x.com/2/spaces/by/creator_ids?user_ids=2244994945&space.fields=creator_id&expansions=creator_id&user.fields=created_at 5단계: 요청을 보내고 응답을 검토하기 모든 구성이 완료되면 “Send” 버튼을 클릭하여 다음과 같은 응답을 확인합니다: 
{
   "data": [
    {
        "creator_id": "2244994945",
        "id": "1zqKVXPQhvZJB",
        "title": "헬로, 월드 👋",
        "state": "실행 중"
   },
   "includes": {
       "users": [
           {
               "created_at": "2013-12-14T04:35:55.000Z",
               "name": "Twitter Dev"
               "id": "2244994945",
               "username": "TwitterDev"
           }
       ]
   }
]
}