ページネーション

​

Recent search のページネーション

​

はじめに

• Recent search エンドポイントは、クエリに対して少なくとも 1 ページで応答し、追加ページが利用可能な場合は JSON レスポンスに next_token を含めます。マッチする投稿を受信するには、レスポンスに token が含まれなくなるまでこのプロセスを繰り返せます。
• next_token は失効しません。同じ next_token 値で複数回リクエストしても、いつリクエストしても同じ結果を受け取ります。
• 投稿は UTC タイムゾーンで逆時系列順に配信されます。これは個々のページ内でも、複数のページにわたっても真です:
  • 最初のレスポンスの最初の投稿は、クエリに一致する最新の投稿になります。
  • 最後のレスポンスの最後の投稿は、クエリに一致する最も古い投稿になります。
• max_results リクエストパラメーターを使用すると、レスポンスあたりの投稿数を設定できます。デフォルトは 10 件で、最大 100 件です。
• あらゆるページネーション実装は、レスポンスペイロードから next_token をパースし、「次ページ」の検索リクエストに含めることを含みます。これらの「次ページ」リクエストの構築方法の詳細は下記を参照してください。

• 履歴の取得 - 対象期間から一致する投稿をリクエストします。これらは通常、履歴リサーチをサポートする一度きりのリクエストです。検索リクエストは start_time と end_time のリクエストパラメーターに基づけます。Recent search エンドポイントは、最新の一致投稿から始まる逆時系列順の投稿でレスポンスします。
• ポーリング - 前回受信した投稿以降に投稿された一致投稿をリクエストします。これらのユースケースはニアリアルタイムに焦点を当てることが多く、関心のある新しい投稿を「リッスンする」ための頻繁なリクエストを特徴とします。Recent search エンドポイントは、「ポーリング」パターンをサポートするために since_id リクエストパラメーターを提供します。Post ID による移動を支援するため、until_id リクエストパラメーターも利用できます。

​

履歴データの取得

"meta": {
        "newest_id": "1204860593741553664",
        "oldest_id": "1204860580630278147",
        "next_token": "b26v89c19zqg8o3fobd8v73egzbdt3qao235oql",
        "result_count": 10
    }

​

ポーリングとリスニングのユースケース

"meta": {
        "newest_id": "12000",
        "oldest_id": "10005",
        "result_count": 7
    }

"meta": {
        "newest_id": "13800",
        "oldest_id": "12500",
        "next_token": "fnsih9chihsnkjbvkjbsc",
        "result_count": 10
    }

"meta": {
        "newest_id": "12300",
        "oldest_id": "12010",
        "result_count": 8
    }