Proxyという名前は透過的なReddit接続ではない
Reddit API Proxyは独立した過去のRedditアーカイブへのゲートウェイです。要求をそのままRedditへ転送する透過型プロキシでも公式APIでもなく、Redditと提携していません。ライブデータ、アクセス制限の回避、OAuthセッション、書き込み、投票、プライベートメッセージは提供しません。既存のクライアントのすべてのルートや権限が同じように働くとは考えないでください。
このサイトの互換性確認では、サーバーが対応するヘッダーに正しいアーカイブキーを入れているかという限定した点を試します。Authorization: Bearer YOUR_API_KEYとX-API-Key: YOUR_API_KEYは両方とも有効です。一方を選んで自分の設定を確認してください。Bearer形式を使っても、旧Reddit OAuthトークンが使えるわけではありません。値はこのドメインのAPIキーです。
キーはサーバーの秘密設定から読みます。URL、ブラウザーの配布ファイル、共有ログに入れないでください。本物を共有せず、宛先ドメイン、ヘッダー名、状態を確認できます。一つの例が成功しても、クライアント全体の互換性、すべての記録の存在、次回も同じ応答が返ることの証明にはなりません。結論は実際に試した範囲に限ってください。
devopsのコメントを少量要求する
例はGET https://api.redditapiproxy.com/v1/comments?subreddit=devops&limit=3です。subreddit=devopsはコミュニティ、limit=3は一応答の最大件数です。三件のコメントの存在は保証されません。このページは作り物のライブ応答を示しません。HTTP状態と実際に存在するフィールドを確認して、ページがアプリケーションの必要を満たすかを評価してください。デモの内容を現在のアーカイブの証拠として使わないでください。
最初は選択した対応ヘッダーだけを送ります。もう一方と比較するときは、別ヘッダーで送る検索は別の要求です。両方成功すれば両方に費用がかかります。一方を使うことは他方が非対応である意味ではありません。YOUR_API_KEYは安全な置き換え用です。本物への変更は自分のサーバー内で行い、試験結果や共有するエラー報告に完全なキーを含めないでください。
応答は平坦な記録です。例えば、存在するコメント本文をローカルの確認待ち一覧へ渡し、必須情報のない記録は別に扱えます。読む、数えるだけなら会話ツリーは不要です。parent_idやlink_idがあれば任意に関係を整理できますが、欠けた親は戻りません。これらは検索フィルターではなく、存在しても完全な会話を保証しません。
応答、上限、費用を別に評価する
検索、投稿、コメントは一要求最大100件、一クエリ最大100ページです。ページごとに別に要求します。結果はアーカイブ文書順で日時、関連度、スコア順ではありません。期間分割やページ反復は全件取得や重複のなさを保証しません。空の結果とHTTPの失敗を分けてください。正しく処理された空の応答も成功した取得になり得ます。
成功した取得は空でも一クレジットです。成功1,000回が$1、一クレジットが$0.001、最低$50のチャージが有料クレジット50,000です。定期契約はなく、有料クレジットは失効しません。クライアントの応答喪失前にサーバーで有料の成功が成立する場合があり、成功した再試行は追加費用です。読み取りがデータを書き換えないことは、無料や同一の結果の証明にはなりません。
メールとパスワードで登録すると、支払い前にキーが一度だけ表示されます。ネットワーク全体の不正利用対策で対象となるアカウントには試用クレジット100が付く場合がありますが、保証ではありません。アカウント、キー、残高はredditapiproxy.com専用です。ドキュメントはルートとエラー、ガイドは再試行の判断、料金は予算、APIキー取得は登録と請求書を説明します。
