01
快速开始
三步完成接入：获取卡密 → 调用核验接口 → 校验返回结果，全程通常不超过 5 分钟。
1
获取卡密
联系客服购买 Key，次数卡 / 时间卡任选。卡密是全部接口的鉴权凭证，请妥善保管。
2
调用核验接口
携带 name / phone / card_key 三个参数请求核验接口，GET / POST 均可。
3
校验返回结果
code=1 核验一致并扣减次数；code=2 核验不一致；其余为参数 / 卡密 / 系统异常。
快速接入示例
terminalCURL
curl -X POST "http://api.henhaiqingtian.cyou/xhapi.php" \ -d "name=张三" \ -d "phone=13800138000" \ -d "card_key=CARDxxxxxxxxxxxxxxxx"
02
服务总览
面向企业与开发者的标准化核验 API 服务，支持按量购买，随时接入。
身份核验接口
基于支付宝官方接口实时核验姓名与手机号是否一致，核验一致扣减次数，结果实时返回。
号段归属查询
覆盖全国省、市、区的号码号段库，支持按号段前缀与地区模糊查询，接口不扣次数。
卡密鉴权体系
次数卡与时间卡双模式，支持剩余次数、到期时间在线查询，接口级鉴权保障调用安全。
合规声明
- 核验对方信息时必须获得对方授权；
- 不得使用国家公职人员 / 在役军人信息请求核验；
- 不得转售本接口；
- 不得使用海外加速节点 / 服务器 / 环境请求本接口。
本站保留对违规调用人的依法追责权利。本站不对使用人承担任何责任，使用人调用本接口造成的一切责任由调用人自行承担，与本站无关。本站不保存任何用户数据。
03
身份核验接口
校验姓名与支付宝账号（手机号 / 邮箱）是否一致，核验一致扣减次数。
请求地址
HTTPGET / POST
http://api.henhaiqingtian.cyou/xhapi.php
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
name | string | 是 | 姓名 |
phone | string | 是 | 支付宝账号（手机号 / 邮箱） |
card_key | string | 是 | 卡密 |
GET 调用示例
URLGET
http://api.henhaiqingtian.cyou/xhapi.php?name=张三&phone=13800138000&card_key=CARDxxxxxxxxxxxxxxxx
POST 调用示例
terminalCURL
curl -X POST "http://api.henhaiqingtian.cyou/xhapi.php" \ -d "name=张三" \ -d "phone=13800138000" \ -d "card_key=CARDxxxxxxxxxxxxxxxx"
返回码说明
| code | msg | 说明 | 扣次数 |
|---|---|---|---|
1 | 核验一致 | 姓名与手机号匹配 | 是 |
2 | 核验不一致 | 姓名与手机号不匹配 | 否 |
3 | 卡密无效 | 卡密不存在 / 已用完 / 已封禁 | 否 |
4 | 参数缺失 | 缺少必填参数 | 否 |
5 | 非标准信息 | 支付宝接口返回异常 | 否 |
响应示例
response.jsonJSON
// 核验一致（姓名与手机号匹配） { "code": 1, "msg": "核验一致", "data": { "remaining_times": 4 } } // 核验不一致（姓名与手机号不匹配） { "code": 2, "msg": "核验不一致", "data": { "remaining_times": 5 } }
04
号段归属查询接口
按号段前缀与地区查询号码号段，支持全国 / 省 / 市维度，查询不扣次数。
请求地址
HTTPGET / POST
http://api.henhaiqingtian.cyou/phone.php
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
dq | string | 是 | 地区：全国 / 省份（如 浙江）/ 城市（如 杭州），支持模糊匹配 |
idpe | string | 是 | 号段前缀（如 180、188），1-7 位数字 |
key | string | 是 | 卡密 |
GET 调用示例
URLGET
http://api.henhaiqingtian.cyou/phone.php?dq=全国&idpe=180&key=CARDxxxxxxxxxxxxxxxx
POST 调用示例
terminalCURL
curl -X POST "http://api.henhaiqingtian.cyou/phone.php" \ -d "dq=全国" \ -d "idpe=180" \ -d "key=CARDxxxxxxxxxxxxxxxx"
返回码说明
| code | msg | 说明 | 扣次数 |
|---|---|---|---|
0 | 查询成功 | 返回匹配的号段列表（smg） | 否 |
1 | 参数缺失 / 不合法 | 缺少必填参数，或 idpe 非 1-7 位数字、dq 超长 | 否 |
2 | 卡密无效 | 卡密不存在 / 已封禁 / 已过期 / 次数用完 | 否 |
3 | 号码库不可用 | 号码库不存在或查询异常 | 否 |
4 | 查询过于频繁 | 超出频率限制（每 IP 每分钟 10 次） | 否 |
响应示例
response.jsonJSON
// 查询成功（dq=杭州，idpe=180） { "code": 0, "msg": "查询成功", "data": { "total": 13, "dq": "杭州", "idpe": "180", "smg": ["1800318", "1800328", "1800338", "..."] } } // 参数缺失 { "code": 1, "msg": "参数缺失：dq、idpe、key 均为必填", "data": [] }
说明：号段查询不扣次数；受每 IP 每分钟 10 次频率限制；时间卡在 data 中额外返回 card_type / expire_at / remain_days 字段。
05
在线测试
使用卡密在线体验身份核验接口，返回结果与线上一致。
身份核验测试
填写姓名、支付宝账号与卡密发起核验