开发者 API 参考文档

通过简单的 HTTP GET 请求，以编程方式批量生成测试手机号码。

接口端点

向以下 URL 发送 HTTP GET 请求：

GEThttps://phone-number.loveyouall.qzz.io/api/generate

在线调试 (Try It)

在下方填写参数,直接调用真实 API 查看 JSON 响应。

参数名: country

quantity

safetyMode

region

city

Query 查询参数

参数名	类型	是否必填	参数描述说明
`country`	string	否	国家/地区代码。支持 "US", "CN", "CA", "GB", "AU", "DE", "FR", "JP", "KR", "IN", "SG", "ES", "IT", "BR", "MX", "RU", "NL"。默认为 "US"。
`region`	string	否	对于各地区，为省州/大区/运营商名称（如 "California", "Ontario", "中国移动"）。不区分大小写。
`city`	string	否	城市名称或3位/2位特定号段前缀（如 "Los Angeles", "138"）。不区分大小写。需同时指定 region。
`quantity`	integer	否	生成的号码条数。范围 1–1000（超过 1000 会自动截断）。默认值：10。
`customPrefix`	string	否	自定义特定长度的号段前缀数字（仅限 0-9 数字）。可选参数。
`safetyMode`	string	否	安全性模式。支持 "realistic"（真实规则号码）和 "safe"（官方预留虚构测试号段，如 555-XXXX）。默认为 "realistic"。
`uniqueOnly`	boolean	否	是否仅生成唯一号码。支持 "true" 或 "false"。默认为 "true"。

代码集成示例

选择您偏好的编程语言或工具来调用生成器 API：

curl -X GET "https://phone-number.loveyouall.qzz.io/api/generate?country=US&quantity=5&safetyMode=safe&uniqueOnly=true"

返回数据格式

接口返回 JSON 数组，包含手机号记录对象。每个对象均包含本地化字段、展示格式与标准的 E.164 字符串。

[
  {
    "id": "c852d129-4112-4981-8ddb",
    "country": "US",
    "region": "California",
    "regionCode": "CA",
    "city": "Los Angeles",
    "areaCode": "213",
    "display": "+1 (213) 932-8419",
    "e164": "+12139328419"
  }
]

响应字段说明

字段	类型	说明
`id`	string	记录的唯一 UUID v4 标识。
`country`	string	国家二字码(如 US、CN)。
`region`	string	州 / 省 / 运营商名称,如 California、中国移动。
`regionCode`	string	存在时的州/省二字码,如 CA(加利福尼亚)。
`areaCode`	string	区号或号段前缀,如 213、138。
`city`	string	城市名称或号段,如 Los Angeles、138。
`display`	string	人类可读的格式化号码,如 +1 (213) 555-1234。
`e164`	string	标准 E.164 格式,如 +12135551234。

错误码说明

API 使用标准 HTTP 状态码,失败时始终返回带 "error" 字段的 JSON 响应体。

状态码	触发场景	响应体
`400`	不支持的国家代码	`{"error":"Unsupported country code: XX"}`
`400`	所选国家下不存在该州/省或城市	`{"error":"Unknown region ... for country US"}`
`400`	customPrefix 包含非数字字符	`{"error":"customPrefix must contain digits only"}`
`400`	未指定 region 就传了 city	`{"error":"city requires region"}`
`500`	生成过程中发生内部错误	`{"error":"Internal Server Error"}`

使用限制

免费且无需认证,不需要 API Key
单次请求最多 1000 条(超出会自动截断)
默认值:country=US、quantity=10、safetyMode=realistic、uniqueOnly=true
safetyMode=safe 使用官方预留的虚构测试号段(如 555-XXXX),不会落到真实用户