経路と認証情報
取得先はhttps://api.redditapicloud.comです。GET /v1/searchは一般検索、/v1/postsは投稿、/v1/commentsはコメントです。/v1/item?id=...は既知の一項目、/v1/subreddits?prefix=...はコミュニティ名の接頭辞検索です。/v1/statusは静的範囲を公開します。独立した過去アーカイブで、公式Redditサービス、ライブ配信、OAuth、書き込み、投票、メッセージ機能はありません。呼び出すためのElasticsearchは不要でも、製品の利用者権限と結果画面は自分のアプリが管理します。
Authorization: Bearer YOUR_API_KEYとX-API-Key: YOUR_API_KEYは両形式が有効です。このドメインのアーカイブキーを使い、Reddit OAuthトークンは入れません。実値はサーバーで追加し、公開コード、ブラウザーパッケージやログから除外します。パネルのSecure HttpOnlyセッションCookieは別です。アカウント、キー、残高を他ブランドで共用できません。https://api.redditapicloud.com/v1/search?q=feedback&subreddit=SideProject&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も応答フィールドで、クエリ引数ではありません。ホスト型検索は任意のElasticsearchクエリ言語や独自のサーバー分析を公開する意味ではありません。
一要求最大100レコード、一クエリ最大100ページで、各ページが別呼び出しです。結果は文書順で時間、関連度、スコア順ではありません。eqは正確な総数、gteは下限、unknownまたはnullは信頼できる総数が不明です。正確な数でも全件保存を証明しません。平坦な記録の関係整理は任意で、閲覧や集計にツリーは不要、欠けた親も復元されません。日付分割や重複除去で完全性は証明できず、コミュニティ集計や接頭辞検索も正確な全体在庫や完全な一覧ではありません。
費用、エラーと状態確認
成功した取得は空でも一クレジット、1,000成功で$1です。無効な要求は差し引かれず上流失敗では予約分が戻ります。クライアントのタイムアウトはサーバー失敗の証拠ではありません。成功後に応答が失われた場合、成功した再試行は追加費用です。読み取り専用でも同じ応答や無料再試行は保証されません。ローカル保存とAPI結果を分けます。保存済み応答の再処理と、APIを新たに呼ぶ再取得は別の行為として製品予算へ記録してください。
400は引数修正、401はキー確認、402は残高確認、429は頻度低下が必要です。試行回数と停止条件を決め、他アカウントで制限を回避しないでください。/v1/statusは公開非課金でも静的範囲とHTTP応答だけで、検索保存先、記録、キー、残高は検査しません。製品では空の成功と一時的エラーを分けて表示できますが、画面を作ってもサービス保証は追加されません。完全性、不変性、永久保存、性能は保証されず、クエリとアプリ処理の結果は別に残します。
