変更前に受け入れ条件を書く
dataengineeringの古い投稿を使う処理を一つ選びます。必須項目、本文がない場合の表示、並び順への依存を書き出し、それぞれを直接対応、ローカル処理、移行対象外に分けて判断します。これによりHTTP成功をクライアント全体の互換性と取り違えず、特定の読み取りの結果として評価できます。Reddit Proxyは独立した過去のアーカイブであり、公式APIや現在のRedditの状態を提供するものではありません。
新しいキーで一ページ保存する
GET https://api.redditproxy.com/v1/posts?subreddit=dataengineering&limit=3 をX-API-Key: <キー>またはAuthorization: Bearer <キー>で実行します。両方ともredditproxy.comのアーカイブ用キーを受け付け、Reddit OAuthのトークンは使いません。パラメータと応答を保存してローカルで検証できるようにし、診断ファイルから秘密情報を除きます。
投稿一覧は/v1/posts、コメント一覧は/v1/comments、検索は/v1/search、既知の単一記録は/v1/item?id=...です。それぞれ別の操作で、単一記録の取得によって会話全体が自動的に読み込まれることはありません。以前のクライアントが使う任意のURLを転送する仕組みでもありません。
存在しない文脈を作らずに対応付ける
data配列とレポートが必要とする項目を検証します。項目なし、空文字、ローカルの変換失敗、空の成功ページを区別してください。記録は平坦です。parent_idとlink_idがあればローカルでグループ化できますが、検索フィルターではなく、完全なスレッドも保証しません。保存した応答から出力を作り、追加取得の前に内容を確認します。
フィルターは意味を確認して移す
qはtitleとtextを検索し、語句は一致する一つのフィールド内でAND条件になります。必要な語をタイトルと本文に分散させるだけでは一致しません。任意のクエリ言語ではありません。fromとtoはUTCのYYYY-MM-DD形式で、toの日全体を含みます。min_scoreは数値の下限フィルターです。_docは時系列、関連度、スコアの順ではなく、ローカルで並べ替えても対象は取得済みの記録だけです。
ページの終了条件を見直す
1リクエスト最大100件、1クエリ最大100ページで、ページは別々に要求します。totalはrelationと合わせて読み、eqはクエリの正確な件数、gteは下限、unknownは信頼できない合計でnullの場合もあります。不明はゼロを意味しません。ページ上限への到達や日付範囲の分割は、網羅性や重複のない収集を証明しません。要求したページと残る疑問を記録します。
失敗時の挙動を試してから接続する
HTTP 400ではパラメータ、401ではキー、402では残高を確認し、429では送信頻度を下げます。空でも取得成功には1クレジットが必要です。無効なリクエストは課金されず、上流の障害では予約分が返されます。ただし、クライアントが応答を失ってもサーバーでは課金対象の成功になっている場合があり、次の成功にも別のクレジットが必要です。
完成したレポートを最初の受け入れ条件と比較します。ローカルの検証成功は、将来の応答が不変である保証ではありません。書き込みや現在の状態を求める機能は、この変換処理の対象外です。/v1/statusは静的なサービス範囲とHTTP応答を示すだけで、上流の稼働状態は調べません。仕様はドキュメント、予算は料金、アカウント管理はキーのページで確認します。
