秘密情報と確認用データの保存先を分ける
サーバーの秘密情報を置く場所と、項目確認に使う応答の保存先を分けて用意します。キーは変換テストのデータには含めません。最初の要求を送るプロセスを決め、その設定に認証情報を渡してください。確認や共有に使うファイルへはコピーしないようにします。
Reddit Extractを利用するにはメールアドレスとUTF-8で12–72バイトのパスワードで登録します。文字数ではなく符号化後のバイト数です。Googleログイン、ウォレット接続やアドレス入力はありません。登録完了直後、支払い前にキーが一度表示されます。その場で安全に保存してください。後日のログインでは同じ値が再表示されず、メール送信もありません。
アカウントパネルはAPI取得ページ自体に統合されています。別のダッシュボードURLを経由せず、この同じページ上でアカウント管理を行うことが可能です。ログイン後、パスワード確認でキーを再生成すると旧キーは直ちに無効になります。パスワードリセット機能はありません。アカウント、キー、残高はドメイン専用です。変換処理やバッチの設定にある古い値を更新してください。
取得プロセスに認証情報を設定する
GET https://api.redditextract.com/v1/search?q=index&subreddit=PostgreSQL&limit=3を例にできます。qは文章、subredditはコミュニティの条件、limitは最大件数です。Authorization: Bearer YOUR_API_KEYかX-API-Key: YOUR_API_KEYを使い、実値はサーバーで設定します。Reddit OAuthではありません。三件の存在や全項目の返却を保証する例ではなく、空の場合も成功です。
再試行の前に最初の結果を見極める
返却された項目と型を確認し、存在しない項目、null、空文字列を区別します。変換失敗を取得失敗として扱わないでください。400は引数、401はキー、402は残高、429は頻度を確認します。/v1/statusはキーや検索の健全性を検査しません。変換規則の公開ファイルには認証値を入れず、必要な要求条件だけを記録できます。
ページを受信できた場合、受信後の変換に失敗した場合、クライアントに使える応答が届かなかった場合を分けます。変換規則は保存済み入力で直せます。応答が失われてもサーバーでは課金対象の取得が成功していることがあり、成功した再試行は別の一クレジットを消費します。時間切れを無料の証拠とせず、結果不明として記録してください。
次の取得に必要なクレジットを用意する
成功した取得は空でも一クレジットです。成功した取得1,000回で$1、最低$50で有料50,000クレジットを追加できます。有料分は失効せず定期契約もありません。試用100クレジットはネットワーク全体の不正利用防止条件によります。初回のキー表示に請求書や先払いは不要です。ローカルで保存済み応答を再変換する処理と、新たな有料取得を分けてください。
追加時はログインして請求書を作り、TRON TRC20のUSDTまたはEthereumメインネットERC20のUSDCを記載の受取先へ正確に送金します。取引ハッシュを検証し、確認済みの実送金だけが残高に反映されます。処理時間は保証されません。セッションはSecure HttpOnly Cookieを使います。ホスト別localStorageには利用者IDと請求書IDが保存され、キー、パスワード、取引ハッシュは保存されません。
請求書は作成から一時間で失効します。送金前に現在の受取先と正確な金額を確認し、以前のメモで代用しないでください。取引ハッシュを送った後でも、提供者の障害で検証が保留になる場合があります。残高が増えたと判断する前に、表示された検証結果を確認します。
