経路と認証
取得先はhttps://api.redditapilabs.comです。GET /v1/searchは一般検索、/v1/postsは投稿、/v1/commentsはコメントです。/v1/item?id=...は既知の一項目、/v1/subreddits?prefix=...はコミュニティ名の接頭辞検索です。/v1/statusは静的な範囲を公開します。独立した過去アーカイブで公式Redditサービスではなく、ライブ配信、OAuth、書き込み、投票、メッセージ機能もありません。情報源の限界をプロトコルに記してください。方法の文書化は不変性、永久保存、標本の代表性を保証しません。
Authorization: Bearer YOUR_API_KEYとX-API-Key: YOUR_API_KEYは両形式が有効です。このドメインのアーカイブキーを使い、Reddit OAuthトークンは入れません。実値はサーバーで追加し、プロトコルでは置き換え値を保ちます。パネルのSecure HttpOnlyセッションCookieは別です。アカウント、キー、残高は他ブランドと共用できません。https://api.redditapilabs.com/v1/search?q=replication&subreddit=science&limit=3は三件の保証や無作為抽出ではありません。条件と実応答を別に記録し、秘密を公開コードや研究ファイルに含めないでください。
フィルターと記録形式
検索、投稿、コメントのフィルターはq、subreddit、author、kind、from、to、min_score、limit、pageです。kindはpostまたはcommentです。日付はUTCのYYYY-MM-DDで、toは指定日全体を含みます。min_scoreは最低条件で並べ替えや品質検査ではありません。idは/v1/item専用で、投稿やコメント一覧の識別子フィルターではありません。parent_idとlink_idも応答の関係フィールドでクエリ引数ではありません。選択条件とその選択効果を記録し、技術的なパラメータ名は翻訳せずに送ってください。
一要求最大100レコード、一クエリ最大100ページで、各ページは別呼び出しです。文書順は時間、関連度、スコア順ではありません。eqは正確な総数、gteは下限、unknownまたはnullは信頼できる総数が不明な状態です。正確な数でも全件保存は証明しません。平坦な記録の関係整理は任意で、閲覧や集計にツリーは不要、欠けた親も復元されません。ページ反復、日付分割、重複除去で完全性は証明できず、コミュニティの検索と集計も完全な一覧や正確な全体在庫とは限りません。
エラー、費用とローカル証拠
成功した取得は空でも一クレジット、1,000成功で$1です。無効な要求は差し引かれず上流失敗では予約分が戻ります。クライアントのタイムアウトはサーバー失敗の証拠ではありません。成功後の応答喪失では、成功した再試行が追加費用になります。読み取り専用でも同一応答や無料再試行は保証されません。API結果とファイル保存を分け、保存済み応答の再処理と新しい取得を区別します。プロトコルにもこの違いを記録して、どの段階の成功または失敗か分かるようにしてください。
400は引数修正、401はキー確認、402は残高確認、429は頻度低下が必要です。試行回数と停止条件を決め、他アカウントで制限を回避しないでください。/v1/statusは公開非課金でも静的範囲とHTTP応答のみで、検索、記録、キー、残高は検査しません。元の応答、条件、時刻、ページ、ローカルファイルハッシュ、コードの版は自分の環境で保管できます。それはAPIの固定版でも将来の同一応答の約束でもなく、性能や継続的な利用可能性も保証しません。
