要求の範囲と保存状況を確認する
Reddit API Proxyは独立した過去のアーカイブへのゲートウェイです。公式やライブのAPI、透過型プロキシ、OAuthセッション、アクセス制限回避のサービスではありません。書き込み、投票、メッセージも提供しません。読み取り要求を送っても同じ結果、全履歴、無料の再試行は保証されません。操作の名前だけでなく、データの上限とクレジット使用を合わせて再送を判断してください。
送信前に自分のサーバーで条件とキー設定を確認します。Authorization: Bearer YOUR_API_KEYとX-API-Key: YOUR_API_KEYの一方を使えます。値はこのドメインのアーカイブキーで、旧Reddit OAuthトークンではありません。秘密ヘッダーを記録せずに作業、検索条件、ページを追ってください。アカウントパネルのCookieはデータ用ヘッダーの代用ではありません。一例の成功もクライアント全体の互換性を証明しません。
小さな開始例はhttps://api.redditapiproxy.com/v1/comments?subreddit=devops&limit=3です。subredditはコミュニティ、limitは一応答の最大件数です。HTTP状態の後で実際に存在するフィールドを確認します。応答を保存済みなら、なぜもう一度取得するのかを決めます。表示だけの失敗は必ずしもアーカイブから再取得する必要がなく、保存や情報の新しさに関する自分の要件に従って判断できます。
HTTPごとに異なる対応をする
HTTP 400は条件の形式や値の問題です。日付はUTCのYYYY-MM-DD形式でtoの日付を含みます。検索、投稿、コメントのlimitとpageは1～100です。非対応のparent_idやlink_idフィルターは外し、idは/v1/item?id=...だけで使います。誤った条件を直さず再送しても原因は解決しません。待ち時間や試行回数を増やす前に入力を確認してください。
HTTP 401はキーの不足または無効です。ヘッダー名、このドメインの値を送っているか、再発行後に設定が更新されたかを確認します。ログイン済みの利用者はパスワード確認で再発行できますが、古い値は直ちに無効になります。パネルが旧値を再表示したり、メールで送ったりするとは考えないでください。失敗の変化を見るためだけに不用意に交換せず、読み取りと送信の設定を先に調べます。
HTTP 402は残高不足、HTTP 429は送信頻度の制限です。402では実際の残高を確認し、必要ならログインして請求書を作り、正しいトークンとネットワークで送金検証を要求します。429では新しい送信を待ちます。徐々に間隔を長くする方法も自分のアプリケーションで検討できますが、一定時間後の成功や無停止のアクセスは保証されません。別アカウントで制限を回避しないでください。
曖昧な通信失敗と有料の成功を分ける
成功した取得は空でも一クレジットです。不正な要求は引き落とされず、上流障害では予約分が戻ります。クライアントの応答喪失前にサーバーで有料の成功が成立する場合があり、成功した再試行は追加費用です。この違いから、接続問題がすべて無料だとは言えません。自分の要件に合わせた試行回数と作業量の上限を定め、前の結果を見ない無限の高速再送を避けます。
検索、投稿、コメントは一要求最大100件、一クエリ最大100ページで各ページを別に要求します。結果はアーカイブ文書順で日時、関連度、スコア順ではありません。min_scoreは最低スコアの条件です。合計のeqは正確、gteは下限、unknownやnullは信頼できる合計がない状態です。正確でも全件保存の証明ではなく、ページ処理と期間分割は網羅性や重複のなさを保証しません。
平坦な記録を読む、数えるだけならツリーは不要です。関係の整理は任意で、欠けた文脈は戻りません。無料の/v1/statusは固定範囲とHTTP応答を示し、アーカイブ、キー、残高は検査しません。ホームにはヘッダー試験、ドキュメントには仕様、料金には予算、APIキー取得にはアカウント操作があります。結果の説明は、実際に受け取って保存できた記録の範囲に限ってください。
