메인 콘텐츠로 건너뛰기

​
팔로우 관리 엔드포인트 시작하기

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

​
사전 준비

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

​
팔로우 관리 요청을 빌드하는 단계

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

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

​
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단계: 누가 누구를 팔로우할지 지정하기

Manage follows 엔드포인트는 두 개의 ID를 받습니다. 하나는 소스 사용자(다른 사용자를 팔로우하거나 언팔로우하려는 사용자)의 ID이고, 다른 하나는 타깃 사용자(팔로우 또는 언팔로우될 사용자)의 ID입니다. 소스 사용자의 ID는 인증된 사용자의 user ID와 일치해야 합니다. 이 경우 본인의 사용자 ID를 지정하면 됩니다. 자신의 ID를 찾는 방법은 두 가지입니다:
  1. user lookup by username 엔드포인트를 사용하여 사용자 이름을 전달하면 id 필드를 받을 수 있습니다.
  2. 액세스 토큰에서 숫자 부분이 본인의 사용자 ID입니다.
타깃 ID는 유효한 어떤 사용자 ID도 될 수 있습니다. 예를 들어 @XDevelopers의 사용자 ID는 2244994945입니다. Postman에서 “Params” 탭으로 이동하여 id 경로 변수의 “Value” 열에 본인의 ID를 입력하세요. “Body” 탭으로 이동하여 target_user_id 파라미터의 값으로 2244994945(@XDevelopers의 사용자 ID)를 입력하세요. 어떤 ID의 앞이나 뒤에도 공백이 없도록 하세요.
KeyValue
id(본인의 사용자 ID)
target_user_id2244994945
“Send” 버튼을 클릭하면 관계 상태가 포함된 응답 객체를 받게 됩니다:
  • “following”: true를 받으면 해당 id가 target_user_id를 성공적으로 팔로우한 것입니다.
  • “pending”: true를 받으면 target_user_id가 보호 계정이므로 팔로우 요청을 승인해야 합니다.

​

4단계: 요청 보내기 및 응답 확인 모든 설정을 마쳤다면 “Send” 버튼을 클릭하세요. 그러면 다음과 같은 응답이 반환됩니다: 
    "data": {
        "following": true,
        "pending_follow": false
    }
}
마찬가지로 사용자를 언팔로우하려면 동일한 Postman 컬렉션에서 “Unfollow a user ID” 요청을 사용하면 됩니다. 다만, 언팔로우 엔드포인트를 사용할 때 source_user_id와 target_user_id 매개변수는 경로 변수로 전달해야 합니다.