Skip to main content
사용자를 차단 및 차단 해제하는 엔드포인트는 Enterprise 플랜에서만 사용할 수 있습니다. Enterprise 관심 양식은 여기에서 작성할 수 있습니다.

Blocks lookup: standard v1.1과 X API v2 비교

standard v1.1의 GET blocks/idsGET blocks/list 엔드포인트를 사용해 왔다면, 이 가이드는 standard v1.1과 X API v2의 blocks lookup 엔드포인트 사이의 유사점과 차이점을 이해하는 데 도움이 될 것입니다.
  • 유사점
    • 인증
  • 차이점
    • 엔드포인트 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 엔드포인트는 요청을 인증할 때 Project와 연결된 developer App의 자격 증명을 사용해야 합니다. 모든 X API v1.1 엔드포인트는 App 또는 Project와 연결된 App의 자격 증명을 사용할 수 있습니다. 응답 데이터 형식 standard v1.1과 X API v2 엔드포인트 버전의 가장 큰 차이 중 하나는 페이로드에 반환될 필드를 선택하는 방식입니다. standard 엔드포인트에서는 많은 응답 필드가 기본적으로 반환되며, 매개변수를 사용해 페이로드에서 어떤 필드 또는 필드 세트가 반환될지 지정할 수 있습니다. X API v2 버전은 기본적으로 사용자 id, name, username 필드만 제공합니다. 추가 필드나 객체를 요청하려면 fieldsexpansions 매개변수를 사용해야 합니다. 이 엔드포인트에서 요청한 모든 user 필드는 기본 user 객체에 반환됩니다. 확장된 Post 객체와 필드는 응답 내 includes 객체에 반환됩니다. 이후 user 객체와 확장된 Post 객체 양쪽에 있는 ID를 매칭하여 확장 객체를 user 객체에 다시 연결할 수 있습니다. 이 새로운 매개변수에 대한 자세한 내용은 각 가이드나 fields와 expansions 사용법 가이드를 읽어보시기 바랍니다. 또한 standard v1.1의 필드를 새로운 v2 필드에 매핑하는 데 도움을 주는 데이터 형식 마이그레이션 가이드도 준비되어 있습니다. 이 가이드는 v2 요청과 함께 특정 필드를 반환하기 위해 전달해야 하는 구체적인 expansion 및 field 매개변수도 제공합니다. 필드 요청 방식의 변경 외에도, X API v2는 Post 및 user 객체를 포함하여 API가 반환하는 객체에 대한 새로운 JSON 설계를 도입하고 있습니다.
  • JSON 루트 레벨에서 standard 엔드포인트는 statuses 배열에 Post 객체를 반환하지만, X API v2는 data 배열을 반환합니다.
  • Retweeted 및 Quoted “statuses”라는 표현 대신 X API v2 JSON은 Retweeted 및 Quoted Tweet이라는 표현을 사용합니다. contributors 및 user.translator_type과 같은 많은 레거시 및 폐기 예정 필드가 제거되고 있습니다.
  • favorites (Post 객체 내) 및 favourites (user 객체 내)를 함께 사용하는 대신, X API v2는 like라는 용어를 사용합니다.
  • X는 값이 없는 JSON 값(예: null)은 페이로드에 기록하지 않는 규칙을 채택하고 있습니다. Post와 user 속성은 non-null 값을 가진 경우에만 포함됩니다.
또한 Post 객체에 다음과 같은 새로운 필드 세트를 도입했습니다:
  • conversation_id 필드
  • context 및 entities를 포함한 두 개의 새로운 annotations 필드
  • 여러 새로운 metrics 필드
  • 특정 Post에 대해 누가 답장할 수 있는지 표시하는 새로운 reply_setting 필드
요청 매개변수 다음의 standard v1.1 요청 매개변수는 두 개의 요청 쿼리 매개변수(user_id 또는 screen_name)를 허용했습니다. X API v2는 숫자 형식의 사용자 ID만 허용하며, 이는 엔드포인트 경로의 일부로 전달되어야 합니다.

코드 예제

차단된 사용자 가져오기 (v2)

cURL

사용자 차단하기 (v2) — Enterprise 전용

cURL