메인 콘텐츠로 건너뛰기

​
개요

filtered stream 엔드포인트 그룹을 사용하면 개발자가 공개 포스트 스트림을 필터링할 수 있습니다. 이 엔드포인트 그룹에는 규칙을 생성·관리하고, 그 규칙을 적용해 일치하는 공개 포스트만 반환하도록 스트림을 필터링할 수 있게 해 주는 여러 엔드포인트가 포함됩니다. 이 엔드포인트 그룹을 사용하면 특정 주제와 이벤트를 실시간으로 수신하고, 경쟁과 관련된 대화를 모니터링하며, 트렌드가 어떻게 형성되는지 파악하는 등 다양한 작업을 수행할 수 있습니다. 개발자는 REST rules 엔드포인트를 사용하여, 정의된 기준과 일치하는 포스트를 필터링하기 위한 규칙을 추가·삭제할 수 있습니다. 이러한 규칙은 메시지 키워드, 해시태그, URL과 같은 포스트 속성과 일치하도록 연산자를 사용해 생성할 수 있습니다. 연산자와 규칙 절은 불리언 로직과 괄호를 조합해, 필터의 매칭 동작을 세밀하게 조정할 수 있습니다.  규칙 집합을 추가한 후에는 웹훅을 등록하면, X가 JSON 형식의 Post objects를 전달하기 시작합니다. 웹훅에는 규칙과 일치하는 콘텐츠만 수신됩니다. 이 엔드포인트는 편집된 포스트를 지원합니다. 웹훅은 하나 이상의 필터와 일치하는 편집된 포스트와 함께, 포스트 ID 배열을 포함한 편집 이력을 수신하게 됩니다. 편집 이력이 없는 포스트의 경우 이 배열에는 단일 ID만 포함됩니다. 편집된 포스트의 경우 이 배열에는 여러 ID가 포함되며, 편집 순서를 반영해 오름차순으로 정렬되고, 가장 최근 버전이 배열의 마지막 위치에 있습니다. 포스트 편집 방식에 대해 자세히 알아보려면 Posts edits fundamentals 페이지를 참조하세요.  참고: 이 엔드포인트 그룹은 규칙을 설정하는 방식이 v2 filtered stream 엔드포인트와 유사합니다. 유일한 차이점은 규칙과 일치하는 포스트를 전달하는 메커니즘입니다.
  • v2 filtered stream 엔드포인트의 경우, 지속적인 연결을 설정하고 규칙과 일치하는 포스트를 수신 대기해야 합니다.
  • 이 filtered stream 웹훅 엔드포인트의 경우, 웹훅을 등록하면 X가 규칙과 일치하는 포스트를 웹훅으로 전달합니다.
이를 통해 클라이언트 측 연결 끊김이나, 서비스의 정상적인 재시작으로 인한 서버 측 중단에서 발생하는 연결 해제를 별도로 처리할 필요가 없어집니다. 초당 수백 개의 이벤트를 전달할 수 있으므로, 웹훅 서버는 이러한 동시 연결 시도를 처리할 수 있어야 합니다. 이 엔드포인트는 현재 Enterprise 개발자에게 제공되며, 다음과 같은 구성을 지원합니다.
  • 프로젝트당 25,000개 이상의 규칙
  • 규칙을 작성할 때 모든 연산자 사용 가능
  • 최대 2048자 길이의 규칙 생성 가능
  • Enterprise 액세스를 위해서는 여기에서 신청
filtered stream에서 반환된 포스트는 월간 Post cap에 포함됩니다.
계정 설정이 엔드포인트에 액세스하려면 다음이 필요합니다.X API v2 엔드포인트에 액세스하는 방법에 대해서는 시작하기 가이드를 참조하세요.