認証とエラーコード
保護された取得にはAuthorization: Bearer YOUR_API_KEYまたはX-API-Key: YOUR_API_KEYを指定できます。どちらも有効です。/v1/statusはキー不要で無料です。キーは登録時、支払い前に一度表示され、ログイン後のパスワード確認で再生成できます。旧キーは直ちに無効になります。キーと残高はこのドメイン専用で、アカウントセッションと取得キー認証は別です。
HTTP 400は不正なリクエスト、401はキーの欠落または無効、402は残高不足、429はレート制限です。不正なリクエストは課金されず、取得元の失敗は予約クレジットを返還します。クライアントが応答を受け取れなくてもサーバーで課金対象の成功があった場合があり、成功した再試行は新しいクレジットを使います。成功した空結果も1クレジットです。
/v1/statusは静的なサービス説明とHTTPサーバーの応答だけを示し、クレジットは消費しません。キー、検索条件、検索基盤や特定の記録の可用性を調べるものではありません。状態応答が成功しても取得が成功するとは判断しないでください。取得した実際のレスポンスを検証し、保存してからローカルの進捗を更新します。
ルートとフィルター
主要なエンドポイントには/v1/search、/v1/posts、/v1/comments、/v1/item、/v1/subredditsがあります。/v1/postsと/v1/commentsはidパラメータを必要とせず、idは/v1/itemでのみ適用されます。/v1/subredditsはプレフィックス一致をサポートしており、検索クエリにはq、subreddit、author、kindなどのフィルターが含まれます。kindパラメータはpostまたはcommentのいずれかです。
検索条件にはq、subreddit、author、kind、from、to、min_score、limit、pageがあります。kindはpostまたはcommentで、fromとtoはUTCのYYYY-MM-DD、toの日を含みます。min_scoreは並べ替えではありません。上限は1回100レコード、1クエリ100ページで、文書順は日時や関連性、スコア順ではありません。ページ反復や期間分割は全件取得を保証しません。
総数関係のeqは正確な一致件数、gteは下限、unknownは信頼できる総数が不明であることを示し、総数がnullの場合もあります。下限を正確な数として扱わないでください。eqの件数は正確でも全件がクライアントに届いた証拠ではありません。/v1/subredditsはprefixとlimitで名前を探索し、その集計数も全体の厳密な数とは限りません。
データ構造と価格
APIレスポンスはフラットレコードとして返され、スレッドツリーではありません。親やリンクのフィールドが含まれる場合、クライアントがローカルでグループ化できますが、完全な会話や系譜を保証するものではありません。親やリンクのクエリフィルターは公開されていません。OAuth、投稿、投票、プライベートメッセージはサポートされていません。
料金は成功した取得1000回で$1、1回1クレジット、つまり$0.001です。最低$50の有料チャージは50000クレジットとなります。有料分は失効せずサブスクリプションもありません。試用100クレジットはネットワーク全体の不正利用防止条件によります。登録とキー表示に支払いは必要なく、メールと12–72 UTF-8バイトのパスワードを使います。
ログイン後に請求書を作り、USDT TRON TRC20またはUSDC EthereumメインネットERC20で現在の受取先へ正確な額を送ります。取引ハッシュを提出して検証を依頼してください。請求書は作成から1時間で期限切れになり、確認済みの実送金をサーバーが検証して初めて残高へ反映されます。固定確認時間はなく、一意の請求書が毎回違う受取先を意味するわけでもありません。
