電話番号インテリジェンス・検証API

カテゴリ セキュリティ

エンドポイント 2

主な機能 7

よくある質問 6

統合前に確認できる信頼シグナル

透明なドキュメント、認証済みリクエスト、見える信頼性情報により、本番投入前に DomScan を評価しやすくなります。

ライブ サービスステータス

統合前に、現在のサービス稼働状況と文書化されたエラー応答を確認してください。

OpenAPI API アーティファクト

OpenAPI、Swagger、Postman、CLI、SDK、MCP のリンクにすぐアクセスできます。

API キー 保護されたアクセス

認証付きエンドポイントは API キーを使用し、呼び出し前に明確なクレジットコストを示します。

10,000 無料枠

毎月 10,000 クレジットから始め、利用が増えたときだけアップグレードできます。

この API で実装できること

このページを本番導入向けの概要として使えます。エンドポイント、例、レスポンス形状、DomScan を製品に組み込むためのワークフローをまとめています。

プロダクトワークフロー

ドメイン確認、DNS インテリジェンス、リスクシグナル、エンリッチメントをオンボーディング、検索、社内ツールに組み込めます。

アナリスト自動化

繰り返しの手動検索を、スケジュールジョブ、アラート、再現可能な調査手順に置き換えます。

クリーンな JSON データ

提供元ページをスクレイピングせず、予測可能なフィールド、文書化済みステータスコード、クレジットコストを使えます。

AI と運用ツール

OpenAPI、SDK、Postman、MCP を通じて、エージェント、ダッシュボード、SOAR プレイブック、CRM に接続できます。

統合ワークフロー

最初のリクエストから本番で繰り返し使える状態までのシンプルな流れです。

一度認証する

文書化されたヘッダーで API キーを送信し、サービス間で一貫したリクエストを保ちます。

例から問い合わせる

curl と HTTP サンプルから始め、パラメータをアプリケーションコードに対応付けます。

運用と監視

ステータスコード、クレジットコスト、レスポンスフィールドを使ってリトライ、ログ、アラートを構築します。

開発者キット

機械可読なドキュメント、リクエスト集、SDK、エージェント用ツールへすぐ移動できます。

OpenAPI スキーマ

クライアント生成やリクエスト/レスポンス形状の確認に使えます。

Postman コレクション

手動テストやチーム共有用のリクエストをすぐインポートできます。

SDK と CLI

ボイラープレートを書く代わりに、保守済みパッケージとコマンドラインワークフローを使えます。

MCP 統合

ドメインインテリジェンスを AI エージェントや社内アシスタントに公開します。

パラメータとレスポンスのマップ

クライアントに接続する前に、入力、出力フィールド、ステータスコードを確認できます。

リクエストパラメータ

パラメータ

phonedefault_countryexpected_countrydialing_from_countrylanguagephones

レスポンスフィールド

レスポンス例

inputnormalized_inputkindvalidpossiblestatusrecommendationvalidation_levelreasonwarningsnumbernumber.e164

ステータス範囲

HTTP ステータスコード

200400401402429500502503504

エンドポイント

POST /v1/phone/validate

クレジット: 1認証: 認証が必要です

phonedefault_countryexpected_countrydialing_from_countrylanguage

POST /v1/phone/validate/bulk

クレジット: 1認証: 認証が必要です

phonesdefault_countryexpected_countrydialing_from_countrylanguage

統合前に確認できる信頼シグナル

透明なドキュメント、認証済みリクエスト、見える信頼性情報により、本番投入前に DomScan を評価しやすくなります。

サービスステータス API アーティファクト

OpenAPI、Swagger、Postman、CLI、SDK、MCP のリンクにすぐアクセスできます。

API キー 保護されたアクセス

認証付きエンドポイントは API キーを使用し、呼び出し前に明確なクレジットコストを示します。

無料枠 無料でサインアップ

毎月 10,000 クレジットから始め、利用が増えたときだけアップグレードできます。

アクティブ リクエスト例

curl と HTTP サンプルから始め、パラメータをアプリケーションコードに対応付けます。

主な機能

厳密な番号計画検証

桁数だけでなく、完全な番号計画メタデータに照らして桁数と数字パターンを確認します。

標準化された形式

解析された内線番号を含む、E.164、国際、国内、RFC 3966の各形式を返します。

成立可能か有効か

桁数が妥当な番号と、番号計画で認識される範囲の番号を区別します。

番号種別とプレフィックス情報

メタデータが対応している場合、番号種別、番号計画上の所在地、想定タイムゾーン、プレフィックスの当初事業者、番号ポータビリティへの対応を特定します。

国別の発信方法と短縮番号

国を指定して国内番号を解析し、発信元に応じたダイヤル形式を生成して、地域の短縮番号や緊急通報番号を認識します。

一括検証

1回のリクエストで最大100件を検証し、それぞれの入力に個別の結果を返します。

オフライン情報源と公式割当情報

DomScanのインフラ上でオフラインメタデータと規制当局の公開スナップショットを使用します。該当する結果には、情報源、ライセンス、更新日、当初の番号割当情報を示します。

リクエスト例

POST /v1/phone/validate bash

curl -X POST https://domscan.net/v1/phone/validate \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"phone":"+34 612 345 678","expected_country":"ES","dialing_from_country":"US","language":"en"}'

レスポンス例

200 OK json

{
  "input": "+34 612 345 678",
  "normalized_input": "+34 612 345 678",
  "kind": "phone_number",
  "valid": true,
  "possible": true,
  "status": "valid",
  "recommendation": "accept",
  "validation_level": "numbering_plan",
  "reason": null,
  "warnings": [],
  "number": {
    "e164": "+34612345678",
    "international": "+34 612 34 56 78",
    "national": "612 34 56 78",
    "rfc3966": "tel:+34612345678",
    "national_number": "612345678",
    "extension": null,
    "country": "ES",
    "country_name": "Spain",
    "country_calling_code": "34",
    "possible_countries": ["ES"],
    "country_match": true,
    "type": "mobile",
    "non_geographic": false
  },
  "intelligence": {
    "status": "available",
    "kind": "phone_number",
    "coverage": {
      "country": "ES",
      "level": "official_allocation_match",
      "global_numbering_metadata": true,
      "official_snapshot_available": true,
      "official_allocation_match": true,
      "official_source_ids": ["cnmc"],
      "matching_source_ids": ["cnmc"],
      "current_carrier_lookup": false
    },
    "location": {
      "country_name": "Spain",
      "country": "ES",
      "granularity": "country",
      "current_physical_location": false
    },
    "possible_time_zones": {
      "values": ["Europe/Madrid"],
      "current_location": false,
      "inference": "number_prefix"
    },
    "original_prefix_carrier": {
      "name": "FOOTBALLERISTA MOBILE SPAIN, S.A. UNIPERSONAL",
      "source_id": "cnmc",
      "evidence": "official_allocation_record",
      "current_carrier": false,
      "portability_may_change_carrier": true
    },
    "portability": {
      "region_supported": true,
      "current_port_checked": false
    },
    "dialing": {
      "from_country": "US",
      "international": "011 34 612 34 56 78",
      "internationally_diallable": true
    },
    "regulator_allocations": [{
      "authority": "CNMC",
      "category": "mobile",
      "status": "assigned",
      "original_assignee": "FOOTBALLERISTA MOBILE SPAIN, S.A. UNIPERSONAL",
      "assigned_on": "2023-11-03",
      "current_operator": false,
      "individual_number_assignment_checked": false
    }],
    "sources": [{
      "id": "google_libphonenumber",
      "name": "Google libphonenumber metadata",
      "license": "Apache-2.0"
    }, {
      "id": "cnmc",
      "name": "Comisión Nacional de los Mercados y la Competencia (CNMC)",
      "type": "official_regulator_snapshot"
    }]
  },
  "live_checks": {
    "assignment": "not_checked",
    "reachability": "not_checked",
    "current_carrier": "not_checked",
    "subscriber_identity": "not_checked",
    "porting": "not_checked"
  },
  "privacy": {
    "upstream_requests": 0,
    "telecom_provider_queried": false,
    "persisted": false,
    "domscan_edge_relay_used": true,
    "third_party_requests": 0
  },
  "limitations": [
    "NUMBERING_PLAN_ONLY",
    "DOES_NOT_PROVE_ASSIGNMENT",
    "NO_LIVE_TELECOM_CHECKS"
  ],
  "credits_used": 1
}

よくある質問

有効な電話番号とはどういう意味ですか？

有効とは、認識されている番号計画の範囲で、番号が文書化された桁数と数字パターンに一致することを意味します。番号が加入者に割り当てられていることは意味しません。

検証によって、番号が使用中で通信可能だと証明できますか？

いいえ。番号計画の検証では、番号が割り当て済み、使用中、通信可能、または通話やSMSを受信可能であることは確認できません。

APIは現在の通信事業者や電話番号の所有者を返しますか？

APIは、プレフィックスの当初事業者または規制当局による番号割当先を返す場合があります。どちらも番号ポータビリティ後の現在の通信事業者を示すものではなく、加入者や電話番号の所有者を特定するものでもありません。

国内電話番号には国の指定が必要ですか？

はい。国際電話の国番号で始まらない場合は、既定の国または地域を指定してください。地域の短縮番号や緊急通報番号を解釈する場合にも国の指定が必要です。

インテリジェンスデータの情報源は何ですか？

世界のメタデータはGoogle libphonenumberを情報源としています。公式の番号範囲およびプレフィックス情報には、CNMC、ARCEP、Bundesnetzagentur、日本のMIC、オーストリアのRTR、Nkom、ポーランドのUKE、台湾のMODA、米国のNANPA、カナダのCNA/CNACが公開するスナップショットも使用される場合があります。米国とカナダの記録は、NPA-NXX中央局コードの割当状況と当初のコード保有者を示すものであり、番号ポータビリティ後の現在の通信事業者を示すものではありません。各結果には、情報源、スナップショット日、カバレッジレベルが記載されます。所在地とタイムゾーンは番号計画のプレフィックスに基づく情報であり、電話機の現在位置ではありません。

電話番号を一括検証できますか？

はい。一括処理エンドポイントは最大100件の番号を受け付け、入力順に結果を返します。オフライン情報の付加が利用できない場合でもローカル検証は完了し、intelligence.statusがフォールバックを示します。

HTTP ステータスコード

正常な応答、認証の問題、クレジット不足、レート制限、データ未検出、上流サービス障害を判別できるよう、クライアントで処理すべきHTTPステータスコードを明記しています。

成功 200

リクエスト成功

不正なリクエスト 400

無効なパラメータ

未認証 401

APIキーまたはセッションが不足しているか無効です。

支払いが必要 402

このリクエストを実行するためのクレジットが不足しています。

リクエスト過多 429

レート制限を超過

サーバーエラー 500

内部エラー

不正なゲートウェイ 502

上流 RDAP エラー

サービス利用不可 503

上流サービスが利用できないか、一時的にレート制限しています。

ゲートウェイタイムアウト 504

上流の問い合わせがタイムアウトしました。

電話番号インテリジェンスを無料で試す

APIドキュメント全文を見る API

電話番号インテリジェンスAPI

統合前に確認できる信頼シグナル

この API で実装できること

統合ワークフロー

開発者キット

パラメータとレスポンスのマップ

エンドポイント

統合前に確認できる信頼シグナル

主な機能

リクエスト例

レスポンス例

よくある質問

関連ツール＆リソース

HTTP ステータスコード