Filtered stream 마이그레이션 개요
Standard v1.1 또는 PowerTrack의 filtered stream 컨슈머를 X API v2로 마이그레이션하려면 엔드포인트, 연산자, 규칙, 인증 요구사항을 매핑하세요.
Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
Standard v1.1 또는 PowerTrack의 filtered stream 컨슈머를 X API v2로 마이그레이션하려면 엔드포인트, 연산자, 규칙, 인증 요구사항을 매핑하세요.
| Description | Standard v1.1 | PowerTrack API | X API v2 |
|---|---|---|---|
| 액세스 | X App | enterprise 계약 및 계정 필요 | developer account(가입), Project 내의 X App 필요 |
| :--- | :--- | :--- | :--- |
| Host domain | https://stream.x.com | https://gnip-stream.x.com | https://api.x.com |
| Endpoint path | 1.1/statuses/filter.json | /stream/powertrack/accounts//publishers/twitter/.json /rules/powertrack/accounts//publishers/twitter/.json /rules/powertrack/accounts//publishers/twitter//validation.json | /2/tweets/search/stream /2/tweets/search/stream/rules |
| 인증 | OAuth 1.0a User Context | HTTP Basic Authentication | OAuth 2.0 App-Only |
| 지원 HTTP 메서드 | POST | GET POST | GET POST |
| 필수 파라미터 | 연결 시 파라미터로 규칙 정의, 다음 중 하나 이상 필요: * follow * track * locations | 스트리밍 연결에 필수 파라미터는 없으며, 선택적으로 backfill 파라미터를 사용. 규칙은 별도 관리 | 스트리밍 연결에 필수 파라미터는 없으며, 응답 형식을 정의하는 선택적 파라미터와 Academic Research access용 backfill recovery 기능 사용 가능. 규칙은 별도 관리 |
| 전달 유형 | Streaming | Streaming REST (규칙 관리용) | Streaming REST (규칙 관리용) |
| 기본 요청 rate limit | 5분당 5회 연결 시도 | 분당 60 요청, POST와 GET 요청 통합 /rules: 특정 스트림의 /rules 엔드포인트 API에 대한 모든 요청(POST 및 GET) 통합 기준 분당 60 요청. | 엔드포인트에 따라 다름. 현재 제한은 rate limits를 참고하세요. |
| 최대 허용 연결 수 | 승인된 사용자당 동시 2개 | 계약에 따라 다중/이중화 연결 지원 | Pay-per-use: 1 |
| 복구 및 이중화 기능 | 없음 | Backfill, 이중 연결, Replay API | |
| Keep-alive 신호/하트비트 | 최소 20초마다 빈 줄(\r\n 등) | 10초마다 빈 줄(\r\n 등) | 최소 20초마다 빈 줄(\r\n 등) |
| Latency | 10초 | 2초 URL unwinding enrichment의 경우 최소 10초 | 10초 |
| 최대 허용 규칙 수 | 1개 규칙 (엔드포인트 연결 요청 내) | 계약에 따라 최대 250,000개 | Pay-per-use: 1,000개 규칙 |
| 규칙 필터 제한 | 연결당 쿼리 1개, 다음 중 하나까지: - 400개 track 키워드 - 5000개 follow 사용자 ID - 25개 location box | 규칙당 최대 2,048자 | Pay-per-use: 규칙당 1,024자 |
| Post JSON 형식 | Standard v1.1 format | Native Enriched 또는 Activity Streams (console에서 선택) | X API v2 format (fields와 expansions 요청 파라미터로 결정되며, v1.1 형식과 하위 호환되지 않음) Standard v1.1 형식에서 X API v2 형식으로 마이그레이션하는 방법은 data formats 마이그레이션 가이드를 참고하세요. Native Enriched 및 Activity Streams에 대한 추가 데이터 형식 마이그레이션 가이드는 곧 출시될 예정입니다. |
| Post 편집 히스토리 및 메타데이터 제공 | ✔ | ✔ | ✔ |
| 고유 기능 | 연결 요청의 쿼리 파라미터로 필터링 수행 구성 UI 없음 | 독립 엔드포인트를 통해 생성된 규칙으로 필터링 수행 계약에서 Enrichment 기능 사용 가능 console.gnip.com UI에서 구성 | 독립 엔드포인트를 통해 생성된 규칙으로 필터링 수행 Metrics 및 URL enrichment 기능 포함 객체 fields 및 expansions를 요청 파라미터로 지정 Post Annotations Conversation ID 연산자 및 필드 Developer Console을 통한 구성 |