最初のリクエスト サーバーからリクエストを送信し、APIキーを非公開にしてください。
cURL リクエストをコピー
curl --fail-with-body \
-H "Authorization: Bearer ${REDDIT_API_KEY}" \
"https://api.redditproxy.com/v1/posts?subreddit=dataengineering&limit=3"ルートとアーカイブ用の認証 ベースURLはhttps://api.redditproxy.comです。GET /v1/searchは投稿とコメントを検索し、/v1/postsは投稿、/v1/commentsはコメントを取得します。GET /v1/item?id=...では一件の識別子を指定します。idはitem専用で、postsやcommentsのフィルターではありません。GET /v1/subreddits?prefix=...はコミュニティ名の先頭部分で検索します。limitで要求件数を制限できますが、集計件数の全体に対する正確性は保証されません。
取得にはAuthorization: Bearer YOUR_API_KEYとX-API-Key: YOUR_API_KEYの両方を使用できます。一方を選んでください。このBearerの値はredditproxy.comのAPIキーで、RedditのOAuthトークンではありません。アカウントパネルのSecure HttpOnlyセッションCookieは別用途で、取得用のヘッダーを置き換えません。キーはサーバーで管理し、旧クライアントの秘密情報を新しいURLのパラメーターに含めないでください。
GET /v1/statusは公開されており、クレジットを消費しません。固定のサービス範囲とHTTPアプリケーションの応答を示します。アーカイブの接続先、クエリの動作、記録の有無、残高は検査しません。データの健全性を確かめるルートではないため、次の取得が成功するという根拠にはできません。実際の取得要求はそれぞれ状態と内容を確認してください。
条件と平坦な記録 検索、投稿、コメントではq、subreddit、author、kind、from、to、min_score、limit、pageを使えます。kindはpostまたはcommentです。日付はUTC基準のYYYY-MM-DD形式で、toの日付を含みます。min_scoreは最低スコアの条件であり、並べ替えではありません。parent_idとlink_idは検索フィルターではなく、これらを追加して会話全体を要求する機能はありません。
limitは1～100、pageは1～100です。一要求は最大100件、一クエリは最大100ページで、各ページは別の要求です。合計はページ数ではなく記録数であり、eqは正確、gteは下限、unknownやnullは信頼できる合計がない状態を示します。正確な合計もクライアントが全件保存した証明ではありません。期間の分割やページの反復は網羅性や重複のなさを保証しません。
Reddit Proxyは公式のライブデータではなく、独立性の高い履歴アーカイブを提供しています。APIレスポンスは複雑な階層スレッドツリー形式ではなく、平坦なレコードとして構成されています。クライアント側でparent_idやlink_idフィールドが存在する場合はローカルでグループ化できますが、サーバーは会話の完全性や祖先情報を保証しません。
読む、分類する、数えるだけなら会話ツリーの構築は不要です。関係を調べるときのグループ化は任意のローカル処理で、欠けた親やコメントを復元しません。結果はアーカイブ文書順で、日時、関連度、スコア順ではありません。旧クライアントの必須フィールドを確認し、不足を黙って既定値に置き換えるのではなく、自分の欠損ルールに沿って扱ってください。
エラーとクレジット HTTP 400は条件の形式や値の問題、HTTP 401はキーの不足または無効、HTTP 402は残高不足、HTTP 429は送信頻度の制限です。旧クライアントの再試行処理をそのまま移さないでください。条件やキーは修正し、頻度の制限では送信を待ちます。HTTP応答とネットワーク接続の失敗を区別し、秘密のヘッダーを記録せずに必要な状態を追えるようにしてください。
成功した取得は空でも一クレジットです。不正な要求は引き落とされず、上流障害では予約分が戻ります。ただしクライアントの応答喪失はサーバーの有料の成功を隠す場合があります。成功した再試行には別のクレジットが必要です。アカウント、キー、残高はこのドメイン専用で、別ブランドの残高は共有されません。公開のstatusではなくアカウントパネルで実際の残高を確認してください。
