backfillMinutes を使用できます。 このパラメータを GET /powerstream リクエストに指定すると、直近 1〜5 分間にルールにマッチした投稿を受け取ることができます。通常、これらの古い投稿は新たにマッチした投稿よりも先に配信され、また投稿の重複排除は行われません。つまり、90 秒間切断されていたにもかかわらず 2 分間分のバックフィルデータを要求した場合、30 秒分の重複した投稿を受け取ることになり、システム側でそれを許容できるようにしておく必要があります。以下は、バックフィルパラメータを指定したリクエスト例です。
curl 'https://api.x.com/2/powerstream?backfillMinutes=5' -H "Authorization: Bearer $ACCESS_TOKEN"
切断時間が 5 分を超えていたと判断できた場合は、recent search endpoint もしくはリカバリ機能を利用して、取り逃したデータを取得できます。
5 分間のバックフィルウィンドウ内に再接続できない場合、Recovery 機能を使用して、直近 24 時間以内に取得し損ねたデータを再取得できます。
ストリーミングのリカバリ機能を使用すると、バックフィルウィンドウを 24 時間まで拡張できます。Recovery を利用すると、取得し損ねたデータの期間を「リプレイ」できます。startTime と endTime リクエストパラメータを使用して接続リクエストを行うと、リカバリストリームが開始されます。接続されると、Recovery は指定された期間のデータを再ストリーミングし、その後切断します。
リクエスト URL の例:
https://api.x.com/2/powerstream?startTime=2022-07-12T15:10:00Z&endTime=2022-07-12T15:20:00Z