ルートの入力と認証
ベースURLはhttps://api.redditapihub.comです。GET /v1/searchは投稿とコメントを検索し、/v1/postsは投稿、/v1/commentsはコメントを取得します。平坦な記録が返り、会話ツリーは組み立てません。GET /v1/item?id=...は識別子が分かる一件を要求します。idはitem専用で、postsやcommentsのフィルターではありません。各ルートに適した入力をクライアントで別々に作ってください。
GET /v1/subreddits?prefix=program&limit=3はコミュニティ名の先頭部分で検索し、最大三件を要求します。prefixは投稿本文のq検索ではありません。コミュニティの件数が全体に対して正確である保証や、アルファベット順の保証はありません。完全なアーカイブ在庫と解釈しないでください。名前から別のデータ要求へ進む場合は、その条件と応答を改めて評価します。
取得用にはAuthorization: Bearer YOUR_API_KEYとX-API-Key: YOUR_API_KEYの両方に対応します。一方を選び、本物のキーはサーバーの秘密設定で保管してください。アカウントパネルのSecure HttpOnly Cookieは別のセッション用で、キーヘッダーの代用ではありません。アカウント、キー、残高はredditapihub.com専用です。別ブランドのキーでは同じアカウントにアクセスできず、URLやブラウザーにも秘密を入れません。
検索条件と応答の解釈
検索、投稿、コメントではq、subreddit、author、kind、from、to、min_score、limit、pageが使えます。kindはpostまたはcommentです。日付はUTC基準のYYYY-MM-DD形式でtoの日付を含みます。min_scoreは最低スコアの条件で、並べ替えではありません。parent_idとlink_idはクエリフィルターではありません。itemやコミュニティのルートにも同じ条件がすべて使えるとは考えないでください。
検索、投稿、コメントのlimitとpageは1～100です。一要求最大100件、一クエリ最大100ページで、ページごとに別に要求します。結果はアーカイブ文書順で日時、関連度、スコア順ではありません。ページ反復や期間の分割は全件取得や重複のなさを保証しません。どの条件とページを保存したか自分の処理記録で追えるようにします。
合計のeqは正確な件数、gteは下限、unknownやnullは信頼できる合計がない状態です。合計はページ数ではありません。正確な値でも全件保存の証明にはなりません。平坦な記録を読む、数えるためにツリーは不要です。関係を調べるときは存在するparent_idやlink_idで任意に整理できますが、欠けた親やコメントは戻らず完全な会話も保証しません。
公開ステータスとエラー
APIの可用性を確認するための/v1/statusエンドポイントは、HTTPサーバーが正常に応答していることを示す静的な開示情報として機能します。このルートはアーカイブの検索バックエンドやレコードの利用可否をチェックするものではなく、データベースの健全性を監視するダッシュボードとも異なります。このステータス確認のリクエストはクレジットを消費せず、無料で行うことができます。これにより、接続の基本的な可用性を事前テストすることが可能です。
HTTP 400は条件の形式や値の問題、HTTP 401はキーの不足または無効、HTTP 402は残高不足、HTTP 429は送信頻度の制限です。条件やキーを修正し、頻度の制限では送信を待ちます。各要求のHTTP応答と内容を個別に確認し、成功した空の結果を失敗と混同しないでください。公開statusではキーや残高も確認できません。
不正な要求は引き落とされず、上流障害では予約したクレジットが戻ります。成功した取得は空でも一クレジットです。クライアントの応答喪失は、サーバーでの有料の成功を隠す場合があります。成功した再試行は追加費用です。すべての失敗を同じ即時再送にする前に、自分の保存状況と再試行の予算を確認してください。
