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.