APIキー、アカウント、取得クレジット

登録したら、ページを離れる前にキーを保存

メールアドレスと、UTF-8で12–72バイトのパスワードを使ってアカウントを作成します。バイト数は、画面上の文字数と同じとは限りません。登録にはメールアドレスとパスワードを使い、Googleログインやウォレット接続は利用できません。現在、パスワードを再設定する機能はないため、安全に保管してください。

登録に成功すると、支払い前にAPIキー全体がすぐ表示されます。表示されている間にバックエンドのシークレット設定へ保存してください。キーはリクエストに繰り返し使う認証情報であり、一回限りのキーではありません。後でアカウントを開いても全体を再表示できず、表示されるのは接頭部分です。サーバーにはキーのハッシュと接頭部分が保存され、元に戻せる完全なキーは保存されません。

キーと残高はこのドメイン専用

保存したキーは、X-API-KeyまたはAuthorization: Bearerを使ってhttps://api.redditapp.comに送信します。モバイルアプリのバイナリ、ブラウザー向けコード、URL、公開するエラー報告には含めないでください。アプリに代わって認証付きのアーカイブリクエストを送るのは、自分のバックエンドです。このページで使うアカウントのセッションは、そのリクエストヘッダーとは別の仕組みです。

アカウント、残高、キーはこのドメインに属します。ネットワーク内の別サイトのキーはここでは使えません。条件を満たす登録には、メールアドレスと送信元IPに基づくネットワーク共通の不正利用防止チェックを経て、100試用クレジットが付与される場合があります。試用には条件があり、無料アクセスの保証でも、毎回の有料チャージに付く特典でもありません。

レコード数ではなくリクエスト数を数える

1クレジットで、正常に完了した取得リクエスト1回を支払います。レコードが0件の正常なレスポンスも対象です。$1は1,000有料クレジットに相当し、最低チャージ額の$50で50,000有料クレジットが得られます。3レコードを返しても100レコードを返しても、1リクエスト1クレジットの料金は変わりません。定期契約はなく、有料クレジットに有効期限はありません。

予約前に拒否された無効なリクエストでは、クレジットは差し引かれません。上流リクエストが失敗した場合は予約済みクレジットが解放されますが、返還の照合処理が保留になることもあります。公開の/v1/statusレスポンスは無料で、検索バックエンドをテストしません。利用分を照合するときは、アカウント残高と、成功・保留・返還済みのリクエスト件数を確認してください。

送金する前に請求書を作る

ここでログインし、追加したい金額の請求書を作成します。対応しているのはTRON TRC20のUSDTと、EthereumメインネットERC20のUSDCです。サーバーが発行した請求書に表示される受取アドレス、正確な支払額、トークン、ネットワークを使ってください。小数点以下も省略せず、表示された桁をすべて守ってください。支払額には照合用の小さな端数が加わる場合があります。

記憶しているアドレスに送ったり、表示された受取先をトークンのコントラクトアドレスに置き換えたりしないでください。請求書が一意でも、受取アドレスが毎回変わるとは限りません。請求書には有効期限が表示され、通常は作成から1時間です。その請求書の指示に従ってください。送金確認やクレジット反映の所要時間は保証されません。

送金を検証し、実際の状態を確認する

指定どおりに送金した後、請求書の検証欄にトランザクションハッシュを貼り付けます。条件に合う実際の送金がサーバーで確認された場合に限り、請求書が支払い済みになり、クレジットが加算されます。保留状態、検証プロバイダーの利用不能、トランザクションハッシュの存在だけでは支払い確認になりません。一時的に検証できないという理由で、もう一度送金しないでください。

ウィジェットは、このブラウザーに最新の請求書への参照と利用者識別子を保持し、同じ利用者がログインしたときに状態を取得できます。復元できるのは最新の請求書であり、全取引履歴を閲覧する機能ではありません。そこにAPIキーは保存されず、請求書が見つからない場合や支払い済みの場合に、代わりの請求書が自動作成されることもありません。

キーを失ったら、影響を把握して再生成する

ログインした利用者は、アカウントのパスワードを入力してAPIキーを再生成できます。古いキーは直ちに無効になるため、そのキーを使うすべてのバックエンド環境を更新できるよう準備してください。表示された新しいキー全体を保存し、古いシークレットを置き換えてから、意図したリクエストで確認します。再生成によって古いキーを復元したり、メールで受け取ったりはできません。

最初の説明用リクエストは「機能の実装」、利用量の見積もりは実装ノートの「アプリ検索機能の予算を立てる」を参照してください。これらの例は、連携の動作や特定のアーカイブ内容を確認したものではありません。