소개
연결 끊김 후 누락된 데이터 복구: 백필(Backfill)
curl 'https://api.x.com/2/tweets/search/stream?backfill_minutes=5' -H "Authorization: Bearer $ACCESS_TOKEN"
Enterprise 액세스가 없거나 연결 끊김 시간이 5분을 초과했다면, recent search 엔드포인트 또는 복구 기능을 사용해 누락된 데이터를 요청할 수 있습니다. 다만, 검색 게시물 엔드포인트에는 sample:, bio:, bio_name:, bio_location: 연산자가 포함되지 않으며, 키워드 및 #hashtag 연산자에서 악센트와 발음 구별 기호 사용 시 일치 방식에 차이가 있습니다. 이로 인해 필터링된 스트림 엔드포인트로 수신되었을 게시물을 모두 완전히 복구하지 못할 수 있습니다.
연결 끊김 후 누락된 데이터 복구: Recovery
Enterprise 액세스가 포함된 Project를 사용 중이며 5분 백필 윈도우 내 재연결이 불가능한 경우, Recovery 기능으로 지난 24시간 내 누락된 데이터를 복구할 수 있습니다.
스트리밍 복구 기능은 백필 윈도우를 24시간으로 확장해 줍니다. Recovery를 사용하면 누락된 구간을 ‘재생’할 수 있습니다. ‘start_time’ 및 ‘end_time’ 요청 매개변수로 연결 요청을 보내면 복구 스트림이 시작됩니다. 연결되면 Recovery가 지정된 기간을 재스트리밍한 뒤 연결을 종료합니다.
동시에 2개의 복구 요청(즉, “두 개의 복구 작업”)을 수행할 수 있습니다. Recovery는 시작 및 종료 시간이 정의된다는 점을 제외하면 기술적으로 백필과 동일하게 동작합니다. 하나의 복구 기간은 단일 시간 범위를 의미합니다.
| Name | Type | Description |
| start_time | date (ISO 8601) | YYYY-MM-DDTHH:mm:ssZ (ISO 8601/RFC 3339). 복구를 시작할 UTC 기준 시작 시각. |
| end_time | date (ISO 8601) | YYYY-MM-DDTHH:mm:ssZ (ISO 8601/RFC 3339). 복구를 종료할 UTC 기준 종료 시각. |