Skip to main content

​
차단 조회: 표준 v1.1과 X API v2 비교

표준 v1.1 GET blocks/ids 및 GET blocks/list 엔드포인트를 사용해 왔다면, 이 가이드는 표준 v1.1과 X API v2 차단 조회 엔드포인트 간의 공통점과 차이점을 이해하는 데 도움을 주기 위한 것입니다.
  • 유사점
    • 인증
  • 차이점
    • 엔드포인트 URL
    • 요청당 사용자 수 제한
    • App 및 Project 요구 사항
    • 응답 데이터 형식
    • 요청 파라미터

​
유사점

인증 standard v1.1 및 X API v2 blocks lookup 엔드포인트는 모두 OAuth 1.0a User Context를 사용합니다. 따라서 이전에 standard v1.1 blocks lookup 엔드포인트 중 하나를 사용해 왔다면, X API v2 버전으로 마이그레이션하더라도 동일한 인증 방식을 그대로 사용할 수 있습니다. 

​
차이점

엔드포인트 URL 요청당 사용자 수 제한 Standard v1.1 엔드포인트는 요청당 최대 5000명의 사용자를 반환할 수 있습니다. 새로운 v2 엔드포인트는 요청당 최대 1000명의 사용자를 반환할 수 있습니다. 한 번에 1000명의 사용자를 모두 반환받으려면 쿼리 매개변수로 max_results=1000을 전달해야 합니다. 그런 다음 응답 페이로드에 포함된 next_token을 다음 요청에서 pagination_token 쿼리 매개변수로 전달할 수 있습니다.   App 및 Project 요구 사항 X API v2 엔드포인트는 요청을 인증할 때 developer App과 Project에 연결된 자격 증명을 사용해야 합니다. 모든 X API v1.1 엔드포인트는 Project에 연결되지 않은 App 또는 Project에 연결된 App의 자격 증명을 사용할 수 있습니다. 응답 데이터 형식 Standard v1.1과 X API v2 엔드포인트 버전 간의 가장 큰 차이점 중 하나는 페이로드에 어떤 필드를 반환할지 선택하는 방식입니다. Standard 엔드포인트의 경우, 많은 응답 필드를 기본값으로 받게 되며, 이후 매개변수를 사용해 페이로드에 반환되어야 하는 필드 또는 필드 집합을 지정할 수 있습니다. X API v2 버전은 기본적으로 사용자 id, name, username 필드만 제공합니다. 추가 필드나 객체를 요청하려면 fields 및 expansions 매개변수를 사용해야 합니다. 이 엔드포인트에서 요청한 모든 사용자 필드는 기본 사용자 객체에 포함되어 반환됩니다. 확장된 게시물 객체와 필드는 응답 내 includes 객체에 포함되어 반환됩니다. 그런 다음 사용자와 확장된 게시물 객체 둘 다에 있는 ID를 매칭하여, 확장된 객체를 다시 사용자 객체와 연결할 수 있습니다.  이러한 새 매개변수에 대해 더 자세히 알아보려면 각 매개변수에 대한 가이드를 참고하거나, 필드와 expansions를 사용하는 방법에 대한 가이드를 읽어 보시기 바랍니다.  또한 standard v1.1 필드를 최신 v2 필드로 매핑하는 데 도움이 되는 데이터 형식 마이그레이션 가이드를 준비했습니다. 이 가이드는 v2 요청에서 특정 필드를 반환하기 위해 전달해야 하는 구체적인 expansion 및 필드 매개변수도 제공합니다.    특정 필드를 요청하는 방식의 변경 사항 외에도, X API v2는 API가 반환하는 객체를 위한 새로운 JSON 설계를 도입하고 있으며, 여기에는 Post 및 user 객체가 포함됩니다.
  • JSON 루트 레벨에서, standard 엔드포인트는 statuses 배열에 게시물 객체를 반환하는 반면, X API v2는 data 배열을 반환합니다. 
  • Retweeted 및 Quoted “statuses”를 참조하는 대신, X API v2 JSON은 Retweeted 및 Quoted Tweet을 참조합니다. contributors, user.translator_type과 같이 레거시이거나 더 이상 사용되지 않는 많은 필드는 제거됩니다. 
  • 게시물 객체의 favorites와 사용자 객체의 favourites를 모두 사용하는 대신, X API v2는 like라는 용어를 사용합니다. 
  • X는 값이 없는 JSON 값(예: null)은 페이로드에 기록하지 않는 관례를 채택하고 있습니다. 게시물 및 사용자 속성은 null이 아닌 값을 가질 때만 포함됩니다.   
또한 다음을 포함하여 Post object에 새로운 필드 세트를 도입했습니다:
  • conversation_id 필드
  • context와 entities를 포함하는 두 개의 새로운 annotations 필드
  • 여러 새로운 metrics 필드 
  • 특정 게시물에 누가 답글을 달 수 있는지 보여주는 새로운 reply_setting 필드
요청 매개변수 다음 표준 v1.1 요청 파라미터는 두 개의 쿼리 매개변수(user_id 또는 screen_name)를 허용했습니다. X API v2에서는 숫자형 사용자 ID만 허용하며, 이 값은 엔드포인트 경로에 포함하여 전달해야 합니다.

​
코드 예제

​
차단한 사용자 조회 (v2)

cURL
curl "https://api.x.com/2/users/123456789/blocking?user.fields=username,verified&max_results=100" \
  -H "Authorization: OAuth ..."

​
사용자 차단 (v2)

cURL
curl -X POST "https://api.x.com/2/users/123456789/blocking" \
  -H "Authorization: OAuth ..." \
  -H "Content-Type: application/json" \
  -d '{"target_user_id": "2244994945"}'