Reddit API Cloud
Reddit API Cloud

次の製品会議を、過去のフィードバックから考える

SideProjectの過去の記録をSaaSの調査画面へ。まず最大3件で動作を確かめ、利用者に見せる範囲と一回の操作で使うリクエスト数を決めます。

APIキーを取得

リクエスト例

cURL

curl --fail-with-body -H "Authorization: Bearer YOUR_API_KEY" "https://api.redditapicloud.com/v1/search?q=feedback&subreddit=SideProject&limit=3"

開発項目を増やす前に、聞きたいことを見つける

小さなプロジェクトの開発者は、フィードバックについてどのように話しているのでしょうか。会議の前にその例を読みたい同僚のために、まずは小さな調査画面を作ります。過去の記録を数件取得して読み、自社の顧客に確かめたいことをメモする。それが最初の機能の役割です。少数の検索結果を需要予測や自動生成の開発計画に変えるものではありません。

小規模SaaSチームにとって、ホスト型Reddit APIの使い道がここで具体的になります。権限のある利用者が例を要求し、自分たちのサーバーがアーカイブを照会します。画面の閲覧権限とメモの扱いは製品側で決め、キーはサーバーに置きます。

検索を任せても、製品の設計は自分たちで行う

Reddit API Cloudは独立した過去のRedditアーカイブで、Redditの公式サービスや提携先ではありません。ライブ配信、OAuth、投稿、投票、メッセージ機能はありません。小規模SaaSチームがこのアーカイブを照会するために、自前のElasticsearchクラスターを運用する必要はありません。ただし全アプリ基盤が管理される意味ではありません。利用者のセッション、製品権限、エラー処理、ローカル保存、結果画面は自分のアプリの仕事です。ホストされた検索と完成済みSaaS製品を区別してください。

最初は利用者が明示的に押す操作から検索を始めましょう。保存したメモを開くたびに、別の有料リクエストを送る必要はありません。調査用の画面、メモ、保存ルールは自分たちのアプリに実装します。この境界があれば、機能全体の価値を小さく試せます。

最大3件を画面まで届けてみる

開始例はGET https://api.redditapicloud.com/v1/search?q=feedback&subreddit=SideProject&limit=3です。qは検索語、subredditはコミュニティ、limitは要求する最大件数です。三件や特定の意見の存在は保証されません。小さな要求でサーバー経由の処理を確認できます。Authorization: Bearer YOUR_API_KEYとX-API-Key: YOUR_API_KEYは両方有効で、このドメインのアーカイブキーを使います。Reddit OAuthトークンではありません。置き換え値はサーバーで実値に変え、ブラウザーのコードやログには秘密を残さないでください。

説明用の合成レスポンスです。実際の問い合わせ結果ではありません：{"data":[],"pagination":{"page":1,"limit":3,"total":0,"relation":"eq"},"credits":{"cost":1,"balance":99}}。残高も架空です。空の成功応答にも1クレジットかかることを示しており、SideProjectの実際の収録状況を示すものではありません。

表示前にdataと、存在するtitleやtextを確認し、内容はテキストとして扱います。レコードはフラットです。parent_idやlink_idがあれば任意にローカルでまとめられますが、会話全体がそろう保証はありません。欠けた文脈は読者にも分かるように残してください。

空の画面にも、正確な説明を用意する

空の結果は、この要求でレコードが返らなかったという意味です。その話題が一度も議論されていないことや、SideProject全体を調べ終えたことの証拠ではありません。取得の失敗には別の表示を用意します。利用できないデータ源を、成功した検索のゼロ件表示と混同しないためです。

先頭の記録はアーカイブ内部の文書順で、関連度順、スコア順、時系列順ではありません。小さなプレビューは接続の試験であり、重要な意見のランキングではありません。受信した本文と同僚の解釈を分けて保存し、網羅性、継続的な可用性、再取得時の同じ結果を前提にしないでください。

一回の操作で使える予算を決める

成功した取得は空でも一要求一クレジットです。成功1,000回で$1、最低$50の追加は有料50,000クレジットです。月額契約はなく有料分は失効しません。試用100クレジットはネットワーク全体の不正利用防止条件によります。アカウント、キー、残高はドメイン専用です。顧客別上限は自分の製品で実装します。一画面が複数要求を実行することもあり、クリック数やレコード数は課金単位ではありません。パネルのSecure HttpOnlyセッションCookieも取得ヘッダーと別です。

サーバー成功後にクライアントが応答を失っても、課金されている場合があります。成功した再試行はもう1クレジットです。無効な要求は課金されず、上流の失敗では予約分が戻ります。キーのページでアクセスを準備し、ドキュメントでパラメータを確認したら、ガイドの手順で公開前の機能を試してください。