リアルタイムプロダクト
リアルタイムエンドポイントはプロダクトを 数値 ID で指定します。バルクエンドポイントは スラッグ で指定します。これらに互換性はありません。バルク呼び出しに ID を渡した場合も、リアルタイム呼び出しにスラッグを渡した場合も、どちらも拒否されます。
この表はサイトのビルドごとに最新のカタログから生成されるため、常に GET /v1/products が返す内容と一致します。
product_ids に指定します。リアルタイムは ID のみを受け付けます。一括の表にある slug はここでは機能しません。1 つのリクエストで選択できるプロダクトは 1 つのシリーズに限られます。| プロダクト名 | モード | 識別子 | 最小 |
|---|---|---|---|
| Amazon 電話番号チェック | 単体(リアルタイム) | #53 | 1 |
| Amazon メールアドレスチェック | 単体(リアルタイム) | #54 | 1 |
| Apple ID 電話番号チェック | 単体(リアルタイム) | #57 | 1 |
| Apple ID メールアドレスチェック | 単体(リアルタイム) | #58 | 1 |
| BAND 電話番号チェック | 単体(リアルタイム) | #60 | 1 |
| Facebook 電話番号チェック | 単体(リアルタイム) | #51 | 1 |
| Facebook メールアドレスチェック | 単体(リアルタイム) | #52 | 1 |
| Instagram 電話番号チェック | 単体(リアルタイム) | #48 | 1 |
| Instagram メールアドレスチェック | 単体(リアルタイム) | #49 | 1 |
| Microsoft 電話番号チェック | 単体(リアルタイム) | #59 | 1 |
| Telegram 電話番号チェック | 単体(リアルタイム) | #50 | 1 |
| Viber 電話番号チェック | 単体(リアルタイム) | #55 | 1 |
| WhatsApp 電話番号チェック | 単体(リアルタイム) | #47 | 1 |
| X 電話番号チェック | 単体(リアルタイム) | #61 | 1 |
この表は、サイトのビルドごとにライブカタログから自動的に更新されます。
この表からの ID の読み取り方
Section titled “この表からの ID の読み取り方”# 列に、渡す値が入っています。リアルタイムプロダクトの場合、それが GET /v1/products におけるプロダクトの id です。
{ "product_ids": [49] }上記の ID は現在のものです。プロダクトは随時追加・廃止されるため、他所からコピーした例ではなく、このページを正とみなしてください。
2つのシリーズ、混在不可
Section titled “2つのシリーズ、混在不可”すべてのリアルタイムプロダクトは phone または email のいずれかのシリーズに属し、1つのリクエストでは 1つの シリーズのプロダクトのみを選択できます。
- 電話の呼び出し(
/v1/realtime/check/phone)は電話プロダクト ID を取ります - メールの呼び出し(
/v1/realtime/check/email)はメールプロダクト ID を取ります
1つのリクエストで両者を混在させると、無効なリアルタイムリクエストとして拒否されます。このルールは検証対象から自然に導かれます。電話番号には国がありますが、メールアドレスにはないため、両者が1回の検証を共有することはできません。
1回の呼び出しで 1〜10個 の ID を渡せます。選択した各プロダクトは、1つの request_id の下で、results 内に独自のエントリと独自の課金を生成します。
{ "product_ids": [49, 52, 54] }11個以上の ID は invalid_realtime_request で拒否されます。1つの識別子に対して10件を超えるチェックを実行するには、それぞれ独自の Idempotency-Key を持つ複数のリクエストを送信してください。
各プロダクトは、結果がキャッシュから提供される場合も含め、プロダクトごとの1チェックあたりの価格で課金されます。カタログエンドポイントは 価格を一切公開しません。GET /v1/products が返すのは id、slug、name、name_translations、mode、series、min_phones のみです。現在の価格はアカウントの料金ページにあります。
どの結果が課金されるかの正確な情報は 課金と返金 を参照してください。