Japan Phone Number Validation & Lookup API

Validate, normalize and classify Japanese phone numbers in one call: fixed-line / mobile / toll-free (0120) / navi-dial (0570) / IP (050), with E.164 + national + international formats, landline region and a best-effort mobile carrier. Handles full-width digits and +81. Fully offline (google libphonenumber) - no external calls.

原始信息汇总

数据集概述：Japan Phone Number Validation & Lookup API

• 功能：在单次调用中验证、标准化和分类日本电话号码。支持检测固定电话、手机、免费电话[phone]）、导航拨号（0570）和IP电话（050）。
• 输入处理：接受全角数字、连字符、括号和 +81 格式的混乱输入。
• 运行模式：完全离线运行，基于 Google libphonenumber，无外部调用，降低中断风险。

端点与功能

• GET /v1/validate：验证号码并返回标准格式（E.164、国内、国际、RFC3966）。必填参数 number，可选参数 country（默认 JP）。返回 valid、type 等字段。
• GET /v1/lookup：返回号码元数据，包括类型、固定电话的地域和手机的运营商。示例返回 type、region、carrier 等字段。
• POST /v1/batch：批量验证最多1000个号码，适用于客户列表清洗或CSV导入。请求体格式为 { "numbers": [...], "country": "JP" }。

输出号码类型

• fixed_line（固定電話）
• mobile（携帯電話，070/080/090）
• toll_free（フリーダイヤル，0120/0800）
• uan（ナビダイヤル，0570）
• voip（IP電話，050）
• premium_rate
• unknown

注意事项

• 运营商信息：基于号码块分配，非MNP（号码可携带）感知，仅为提示，非绝对准确。
• 地域信息：仅固定电话返回地域（城市/都道府县级别），手机、免费电话和0570返回 null。
• 引擎：基于 Google libphonenumber（Python 移植版，Apache-2.0 许可），元数据定期更新。