JSON の電話コードデータ

電話番号、電話コード、国を確実に識別。

phonecode.app API は市外局番、国番号、サービス・緊急番号の構造化データと、国内番号から国際形式への変換を提供します。店舗、CRM、サポートツール、見込み客フォーム、内部データの品質管理向けです。

GET /api/search.php?q=030 JSON

{
  "ok": true,
  "query": "030",
  "results": [
    {
      "code": "030",
      "name": "Berlin",
      "region": "Deutschland",
      "kind": "Ort",
      "format": "+49 30"
    }
  ]
}

28,608 レコード

5,200 ドイツの地域網

206 国と地域

76 サービス・緊急番号範囲

382 携帯番号範囲

クイックスタート

数分で最初のリクエストを。

アカウントを確認

顧客アカウントに登録し、メールアドレスを確認してください。

キーの作成

API キーを作成します。平文の値は一度だけ表示されます。

JSON を取得

キーは Authorization ヘッダー内の Bearer Token としてのみ送信してください。

Bearer Token

curl "https://vorwahl.app/api/search.php?q=040" \
  -H "Authorization: Bearer vwl_DEIN_API_SCHLUESSEL"

キーを安全に送信

API キーを URL、ブラウザー履歴、プロキシログ、参照元に含めてはいけません。そのため、クエリパラメーターによるキーの送信は受け付けません。

エンドポイント

検索、アカウント、請求向けの明確な JSON エンドポイント。

GET

/api/search.php

電話コード、電話番号、場所、国、サービス・緊急番号を検索します。

パラメーター	説明
q	検索語。例：`030`、`Berlin`、`+44`、`0800`。
limit	省略可能。結果は 1～50 件。既定値：12。

GET

/api/internationalize.php

各国の国内電話番号をコピー可能な国際形式へ変換します。

パラメーター	説明
number	国内番号。例：`0343 222 1234`。
country	番号の国の ISO コード。例：`GB`、`DE`、`AT`。既定値：`DE`。

curl "https://vorwahl.app/api/internationalize.php?number=0343%20222%201234&country=GB" \
  -H "Authorization: Bearer vwl_DEIN_API_SCHLUESSEL"

{
  "ok": true,
  "input": "0343 222 1234",
  "country": "GB",
  "international": "+44 343 222 1234"
}

GET

/api/health.php

状態と現在のデータ件数を返します。

GET

/api/billing/plans.php

利用可能な API プラン、上限、PayPal の状態を返します。

POST

/api/account/api-keys.php

ログイン済みで確認済みのユーザーに API キーを作成します。

応答形式

各結果には表示、検証、整形に必要なデータが含まれます。

code電話コードまたは番号範囲。例：030 または +49。

name場所、国、サービス、または緊急サービスの名称。

kindOrt, Land, Region, Dienst, Notruf.

local_format推奨される国内表示形式。

international_format推奨される国際表示形式。

advice料金、利用方法、ダイヤル方法に関するわかりやすい案内。

APIプラン

公平な無料利用を備えた、予測可能な月間割当。

Das Lizenzangebot richtet sich ausschließlich an Unternehmen. Aufgrund der Kleinunternehmerregelung gemäß § 19 UStG wird keine Umsatzsteuer berechnet.