仕事と範囲を定義
Reddit Data Streamは独立した過去アーカイブで、公式Redditやライブデータではありません。変更フィード、SSE、WebSocket、OAuth、書き込み、投票、メッセージはありません。スケジューラーの定期GETはそれらの機能や更新日程の証拠にはなりません。仕事のコミュニティ、種別、期間、ページ上限を書きます。実行ごとのローカルIDは試した要求の追跡に使えますが自分の制御記録です。サーバーの固定スナップショットや一度だけの配送機構ではありません。結果は最新イベント監視ではなく、過去の限定的な取得として説明します。
GET https://api.redditdatastream.com/v1/posts?subreddit=apacheairflow&limit=3&page=3は開始例で三件を保証しません。コメントは/v1/comments、一般検索は/v1/searchを使えます。fromとtoはUTCのYYYY-MM-DDでtoは一日全体を含み、kindはpostかcommentです。min_scoreは最低条件で並べ替えません。idは一覧フィルターではなく/v1/item?id=...は既知の一項目です。期間分割は仕事を整理できますが、最後のレコードの日付は以前の全取得や新規データの安全な境界の証拠ではありません。ページ番号も時系列の進行ではありません。
取得、書き込み、ロードを確認
Authorization: Bearer YOUR_API_KEYかX-API-Key: YOUR_API_KEYを使います。両方有効で、このドメインのアーカイブキーを使いReddit OAuthトークンではありません。秘密はサーバーで守りファイルやログから除きます。応答後は各レコードのオブジェクトをJSONエンコーダーで符号化し、一行一オブジェクトと改行でJSONLへ書けます。本文内の改行はエンコーダーに処理させ、応答のラッパーをレコードとして書かないでください。変換は自分のコードでサーバーのJSONL出力ではありません。欠損値を捏造せず元の応答を分けて保管できます。
各試行の条件、ページ、時刻、HTTP結果、ファイル書き込み、ロードを別に記録します。応答成功後に書き込みが失敗した場合、番号だけ進めると未保存の結果を飛ばすおそれがあります。再要求前に手元のファイルを確認してください。一時ファイルを検査してからロードするのはクライアントの設計で、欠落のない再開や同一応答の保証ではありません。平坦な記録の閲覧や集計にツリーは不要で、関係整理は任意、欠けた親も復元されません。番号は永続カーソルではなく、ローカル重複除去も全体の一意性や網羅性を証明しません。
上限、エラー、予算で停止
一要求100レコード、一クエリ100ページが上限です。文書順は時間、関連度、スコア順ではありません。eqは正確な総数、gteは下限、unknownまたはnullは信頼できる総数が不明です。正確な数でも全件保存は証明しません。期間分割、ページ反復、重複除去は完全で一意な取得を保証しません。コミュニティ探索も完全なアルファベット順一覧や正確な全体集計ではありません。仕事の報告に取得ページ、ロードしたファイル、停止理由を記載し、全アーカイブの複製や完全な変更履歴として説明しないでください。
成功した取得は空でも一クレジット、1,000成功で$1です。無効な要求は差し引かれず上流失敗では予約分が戻ります。サーバー成功後の応答喪失では成功した再試行が追加費用です。400は引数、401はキー、402は残高、429は頻度を確認して試行を限定します。/v1/statusは公開非課金でも静的範囲とHTTP応答のみで検索、記録、キー、残高は検査しません。永久保存や性能は保証されません。ローカル再処理と再取得を分け、利用では法と第三者の権利も考慮します。
