必要なAPIのプランを選ぶ

キーとオリジンのチェックを通過した認証済みの呼び出しはそれぞれ1リクエストとして数えられます。訪問者ジオロケーションの呼び出し、検索した各IP、チェックした各メールアドレス、各登録チェック、各不可能な移動チェックが対象です。その後入力検証で失敗した呼び出しも数えられます。キーの欠落・無効、許可されていないオリジン、1分あたりのレート制限で拒否された呼び出しは数えられず、リスクのベースライン削除やメールリストジョブのステータス確認も数えられません。

これは固定された1分間の時間枠で、時計の分単位に合わせられています—移動平均ではありません。Freeプランでは、例えば10:32:00から10:32:59の間に最大30リクエストを送信できます。カウンターは10:33:00にゼロにリセットされます。超えた場合はHTTP 429が返され、時間枠がリセットされるまでの秒数を示すRetry-Afterヘッダーが付与されます。これは以下の月間リクエストボリュームとは独立したもので、バーストレートを制限するものであり、総利用量を制限するものではありません。この制限はアイテム数ではなくAPI呼び出し数で数えます。最大100件のIPまたはメールアドレスを含むバッチや、メールリストジョブの作成は1リクエストとして数えられます。ただし、含まれる各IPやアドレスは引き続き月間リクエストボリュームに個別に計上されます。

キーを自動的に停止することはありません。プランの上限に常に近い状態が続く場合は、いつでもダッシュボードからアップグレードできます—コードやAPIキーの変更は不要です。

訪問者ジオロケーションはエッジのリクエストデータを読み取り、地域情報の拡充をローカルで行うため、そのコスト — そして価格 — をほとんどのプロバイダーの同等プランよりも大幅に低く抑えられます。サーバーサイドのIPルックアップは別売りではなく同じプラン・同じ価格に組み込まれています。各プランにはリクエスト上限とIPルックアップの割り当ての両方が含まれ、どちらもそのプランの共有月間プールから消費されます。

訪問者ジオロケーションとIP検索のレスポンスには、ソースデータがある場合に地域情報の補完が含まれます。対象プランにはリスト型のセキュリティ指標も含まれます。メールチェックはドメインレベルの別の結果を返します。レイテンシはリクエストや有効な機能によって異なります。

はい。GET /v1/geoは引き続き、実際に接続しているIPをクライアント側で解決する、訪問者自身のルックアップ専用です。任意のIPをルックアップする場合、GET /v1/lookup/{ip}（単一）とPOST /v1/lookup（バッチ、1回の呼び出しで最大100件のIP）は、公開可能キーではなくシークレットキーで認証されるサーバー間エンドポイントです — キーはバックエンドに留まり、ブラウザに送信されることはありません。どちらも当社独自のリアルタイムネットワークデータではなく、サードパーティのIPジオロケーションデータベースを使用しており、レスポンス形式が異なり、相対的な精度の検証済みランキングもありません — 具体的なプロバイダーと必要な帰属表示についてはデータソースをご覧ください — 利用量はルックアップしたIPごとに課金され、ジオリクエストと1対1でプランの共有月間プールから消費されます（合計ルックアップ数に対する別枠の上限については、上記のプランのIPルックアップ割り当てをご覧ください）。このエンドポイントは訪問者自身が呼び出すのではなく、お客様の顧客が提供するIPをルックアップするため、Watch-IPはお客様に代わってそのサードパーティデータの処理者となります — これがお客様自身のコンプライアンス義務にとって何を意味するかについてはDPAをご覧ください。

POST /v1/risk/checkは、指定されたIPのサードパーティによる位置情報を保存済みのユーザーベースラインと比較し、low/medium/highのリスクとimpossibleTravelフラグを返します。バックエンドのBearerシークレットキーを使用します。利用可否、提供状況、料金についてはお問い合わせください。独立したリスクプランの適用とチェックアウトの提供状況は未確認です。VPNの切り替えやモバイル回線のルーティングにより誤検知が発生することがあります。

はい。POST /v1/email/validate は、オリジン制限付きの公開可能キーで、構文、既知の使い捨てドメイン、ドメインにメールサーバーがあるか、入力ミスの可能性、ロールアドレスをチェックし、理由付きで受け入れ・要確認・拒否の判定を返します。バックエンドからは、POST /v1/email/batch が1回の呼び出しで最大100件、リストジョブが最大100,000件を処理し、POST /v1/signup/check は登録元IPのネットワークシグナルを加えます。チェックした各アドレスはプランの月間枠の1リクエストとして数えられます（リストジョブでは重複を除いた各アドレスを1回だけ課金）。いずれのチェックもメールボックスには接続しないため、メールボックスの存在、所有者、配信可能性を確認するものではありません。

キーの種類によります。公開可能キー（GET /v1/geo と POST /v1/email/validate 用）は、StripeやGoogle Mapsの公開可能キーと同様にページのソースに含めることを前提としています。アクセス制御はオリジン制限で、各キーは登録したドメインからのみ機能し、CORSは一致するオリジンにのみ許可されます。シークレットキー（IP検索、メール一括チェック、登録チェック、不可能な移動チェック用）はバックエンドに保管し、ブラウザのコードには決して含めないでください。

JavaScript/TypeScript、Python、PHP、Go、Flutter/Dart向けのSDKソースパッケージがあります。利用前にパッケージの提供状況と対応エンドポイントをご確認ください。GET /v1/geoは常に接続元の呼び出し元を特定するため、バックエンドからの呼び出しではウェブサイトの訪問者を特定できません。指定したIPにはシークレットキーによるルックアップをご利用ください。

はい、ただしオプトインです:リクエストに?include=hostnameを追加(またはSDKでinclude: ["hostname"])すると、DNS over HTTPSのPTRルックアップによって解決されたhostnameフィールドがレスポンスに追加されます。PTRレコードがない場合はnullになります。上記の常時有効なエンリッチメントフィールドとは異なり、これはリクエスト内で実際にネットワークルックアップを行うため、すべての呼び出しにレイテンシを追加しないよう、デフォルトでは無効になっています。

対象プランでは、訪問者ジオロケーションとIP検索の両方のレスポンスに、リスト型の isVpn、isTor、isDatacenter、isThreat、isSanctionedNetwork フラグが含まれます。Freeではセキュリティは省略されます。IPv4はリストとASNによる照合に対応しています。IPv6はVPN、データセンター、脅威の範囲とASN照合に対応していますが、Torはカバーしていません。本番環境でのカバレッジは利用可能なフィードに依存します。falseは利用可能なデータに一致がなかったことを意味し、安全の保証ではありません。これらのシグナルは確定的な制裁スクリーニングではありません。

はい—すべてのレスポンスにはcomplianceオブジェクトが含まれます:isGDPR(EU/EEA+英国)、usPrivacyLaw(訪問者の州に応じた適用される米国州法、例:CCPA/CPRAまたはVCDPA)、isLGPD(ブラジル)、算出されたrequiresCookieConsentフラグ、大まかなdataResidencyZone、そしてisEmbargoedCountry(OFACの包括的な国別禁輸措置)です。通貨や国番号と同様に、追加コストなしで全プランに含まれます。これは訪問者の位置情報から算出された一次的な法域シグナルであり、法的アドバイスではありません—コンプライアンス要件については必ず自社の法律顧問にご確認ください。

はい—すべてのレスポンスにはlocaleオブジェクトが含まれます:suggestedLocaleは、訪問者の国とブラウザ自身のAccept-Languageヘッダーを組み合わせたBCP47ロケールで、実際にその地域で話されている言語を優先します(例:カナダの訪問者からのAccept-Languageが「fr」の場合、「fr-FR」ではなく「fr-CA」を返します)。ヘッダーに一致するものがない場合は、その国の既定ロケールにフォールバックします。同じオブジェクトにはmeasurementSystem(メートル法/ヤードポンド法)、firstDayOfWeek、dateFormatも含まれるため、地域の書式規則を自分で再実装する必要がありません。追加コストなしで全プランに含まれます。

はい—すべてのレスポンスにはholidayオブジェクトが含まれます:isPublicHolidayToday、todayHolidayName、そしてnextHoliday(日付と名称)を訪問者の国について提供します。これは厳選された静的テーブル(現在約40か国—G20+EU/EEA+英国)から算出され、Nager.Dateを出典として、リクエスト時の計算ではなく年1〜2回程度の手動更新で反映されます。このリストに含まれない国の場合はnullとなり、全国的な祝日のみを対象とし、州・省単位の祝日は対象外です。追加コストなしで全プランに含まれ、他の国も要望に応じて追加可能です。

静的なマッピングにより、おおよそのIP位置情報に基づいた年齢・法域の参考情報を提供します。本人確認や年齢確認を行うものではなく、適用される要件については別途ご確認ください。