アカウント登録とAPIキーの取得
メールアドレスとUTF-8で12–72バイトのパスワードを使って登録します。文字数ではありません。Googleログインやウォレット接続は提供しません。キーは登録直後、支払い前に一度表示されます。安全に保存してください。後で同じキーを再表示する機能はなく、ログイン後のパスワード確認で再生成すると古いキーが直ちに無効になります。
登録やキー表示に有料チャージは必要ありません。100クレジットの試用はネットワーク全体の不正利用防止条件によります。取得にはAuthorization: Bearer YOUR_API_KEYまたはX-API-Key: YOUR_API_KEYを使えます。キーと残高はsubredditapi.com専用です。実際のキーを公開コードや共有研究記録に含めず、サーバー側で管理してください。
支払いとトップアップの手順
クレジットを追加するには、ログインした後にユニークなインボイスを作成します。インボイスには受取アドレスと正確な額が表示されるため、USDT(TRC20)またはUSDC(ERC20 Ethereumメインネット)でその正確な金額を送信します。インボイスは作成後1時間で有効期限が切れるため、注意してください。送金後、トランザクションハッシュを貼り付けて確認済みの送金を検証し、残高に反映させます。
1000回の成功した取得は$1、1クレジットは$0.001です。最低$50の有料チャージは50000クレジットで、有料分は失効せずサブスクリプションもありません。成功した空結果は1クレジットです。不正なリクエストは課金されず、取得元の失敗は予約分を返還します。応答を失ったクライアントの再試行が成功すれば別途課金されます。
送金後の確認や残高反映に決まった時間はありません。現在の請求書のトークン、ネットワーク、受取先、正確な金額を使い、ハッシュを提出して検証を依頼してください。受取アドレスが毎回変わるとは限りません。ログインしただけ、または送金しただけで確認が終わるわけではなく、確認済みの実際の送金をサーバーが検証する必要があります。
データの取得とクエリ機能
最初の検索には/v1/search?q=soil&subreddit=gardening&limit=3を使えます。最大3件を求めるもので、3件の存在や全体の代表性を保証しません。1リクエスト100レコード、1クエリ100ページが上限であり、ページ反復も全件取得の約束ではありません。別コミュニティとの比較は条件を揃えた別リクエストで行ってください。
クエリでは、キーワード、サブレディット名、著者、日付範囲、スコアなどのフィルターを利用できます。スコアはソート基準ではなくフィルターのみに使用され、アーカイブのドキュメント順序は時系列や関連性とは異なります。スレッドツリーや親/子のフィルターはサーバー側で提供されず、クライアント側でローカルにグループ化することが推奨されます。各エンドポイントの仕様に従って、適切なパラメータを指定してください。
