价格配置

1. 运营商二要素核验 api2ys

验证姓名与手机号是否一致。返回运营商及携号转网信息。

参数类型必填说明
namestring是姓名（2‑20 字）
mobilestring是手机号（11 位，不支持 192）
curl "https://388377.xyz/API/api2ys.php?key=YOUR_API_KEY&name=刘筱婷&mobile=135*****740"
{
  "success": true,
  "data": {
    "name": "刘筱婷",
    "mobile": "135*****740",
    "is_consistent": false,
    "original_operator": "移动",
    "current_operator": "移动",
    "is_xhzw": "否"
  },
  "request_id": "log_15"
}

2. 运营商二要素核验(推荐) api2ys2

不返回运营商及携号转网信息。

参数类型必填说明
namestring是姓名
mobilestring是手机号
curl "https://388377.xyz/API/api2ys2.php?key=YOUR_API_KEY&name=马**&mobile=155037****9"
{
  "success": true,
  "data": {
    "name": "马**",
    "mobile": "155037****9",
    "is_consistent": true,
    "friendly_msg": "一致",
    "verification_result": "1"
  },
  "request_id": "log_22"
}

3. 运营商三要素核验 api3ys

验证姓名、身份证号与手机号。返回运营商及携号转网信息。

参数类型必填说明
namestring是姓名
idcardstring是18 位身份证号
mobilestring是手机号
curl "https://388377.xyz/API/api3ys.php?key=YOUR_API_KEY&name=张三&idcard=110101199001011234&mobile=13800138000"
{
  "success": true,
  "data": {
    "name": "张湫茗",
    "idcard": "231026199708310329",
    "mobile": "13316243754",
    "is_consistent": true,
    "original_operator": "电信",
    "current_operator": "电信",
    "is_xhzw": "否"
  },
  "request_id": "log_31"
}

4. 运营商三要素核验(推荐) api3ys2

不返回运营商及携号转网信息。

参数类型必填说明
namestring是姓名
idcardstring是身份证号
mobilestring是手机号
curl "https://388377.xyz/API/api3ys2.php?key=YOUR_API_KEY&name=张三&idcard=110101199001011234&mobile=13800138000"
{
  "success": true,
  "data": {
    "verification_result": "1",
    "name": "张三",
    "idcard": "110101199001011234",
    "mobile": "13800138000",
    "message": "三要素一致"
  },
  "request_id": "log_31"
}

5. 手机空号检测 apikh

参数类型必填说明
mobilestring是手机号
curl "https://388377.xyz/API/apikh.php?key=YOUR_API_KEY&mobile=13800138000"
{
  "success": true,
  "data": {
    "mobile": "13800138000",
    "status": "1",
    "status_name": "实号",
    "description": "正常在使用的号码"
  },
  "request_id": "log_8"
}

6. 话费余额查询 apibalance

参数类型必填说明
phonestring是手机号
curl "https://388377.xyz/API/apibalance.php?key=YOUR_API_KEY&phone=19879950868"
{
  "success": true,
  "data": {
    "mobile": "19879950868",
    "money": 40.17,
    "prov": "广东",
    "city": "深圳",
    "isp": "中国移动"
  },
  "request_id": "log_42"
}

7. 企业工商四要素 apiqy4ys

参数类型必填说明
company_namestring是企业名称（2‑100 字）
credit_codestring是统一社会信用代码
legal_personstring是法人姓名
legal_idcardstring是法人身份证号
curl "https://388377.xyz/API/apiqy4ys.php?key=YOUR_API_KEY&company_name=XX有限公司&credit_code=91110000XXXXXXXXXX&legal_person=李四&legal_idcard=..."
{
  "success": true,
  "data": {
    "raw_response": {
      "msg": "成功",
      "success": true,
      "code": 200,
      "data": {
        "orderNo": "205848709557958186",
        "companyName": true,
        "creditNo": true,
        "legalPerson": false,
        "idCard": false
      }
    }
  },
  "request_id": "log_45"
}

8. 人脸三要素 apirlhy

支持文件上传、Base64、图片 URL。

参数类型必填说明
namestring是姓名
idcardstring是身份证号
imagefile/string是人脸图片（≤4MB）
curl -F "image=@face.jpg" "https://388377.xyz/API/apirlhy.php?key=YOUR_API_KEY&name=张三&idcard=..."
{
  "success": true,
  "data": {
    "name": "孙**",
    "idcard_masked": "210381***********3",
    "validate_result": "3",
    "similarity": 520.58
  },
  "request_id": "log_52"
}

9. 身份证二要素 apisfz2ys

参数类型必填说明
namestring是姓名
cardNostring是身份证号（含港澳台居住证）
curl "https://388377.xyz/API/apisfz2ys.php?key=YOUR_API_KEY&name=张三&cardNo=110101199001011234"
{
  "success": true,
  "data": {
    "isok": true,
    "realname": "张*",
    "idcard": "110101****1234",
    "area": "北京市",
    "sex": "男",
    "birthday": "19900101"
  },
  "request_id": "log_66"
}

10. 手机号实时状态 apistatus

广电号段（192）每次查询扣3次次数。

参数类型必填说明
phonestring是手机号
curl "https://388377.xyz/API/apistatus.php?key=YOUR_API_KEY&phone=13194003889"
{
  "success": true,
  "data": {
    "mobile": "13194003889",
    "state_desc": "正常",
    "area": "福建-三明",
    "is_carry_number": "否",
    "original_operator": "中国联通",
    "current_operator": "中国联通"
  },
  "request_id": "log_55"
}

11. 手机号实时状态(推荐) apistatus2

查询手机号在网状态、归属地、运营商、携号转网。仅在上游返回有效数据时扣次数。

参数类型必填说明
mobilestring是手机号（不支持 192）
curl "https://388377.xyz/API/apistatus2.php?key=YOUR_API_KEY&mobile=13800138000"
{
  "success": true,
  "data": {
    "mobile": "13800138000",
    "status": "1",
    "status_text": "正常",
    "carrier": "移动",
    "mnp": "否",
    "area": "北京"
  },
  "request_id": "log_105"
}

12. 银行卡实名认证 apiyhk

支持二要素（姓名+卡号）、三要素（+身份证）、四要素（+预留手机号）。

参数类型必填说明
namestring是姓名
accountNostring是银行卡号（16‑19 位）
idCardCodestring否身份证号（三/四要素必填）
bankPreMobilestring否预留手机号（四要素必填，需同时提供身份证）
curl "https://388377.xyz/API/apiyhk.php?key=YOUR_API_KEY&name=张三&accountNo=6222021234567890&idCardCode=...&bankPreMobile=..."
{
  "success": true,
  "type": "四要素",
  "conclusion": "一致",
  "detail": "认证成功",
  "input": { "name": "张三", "accountNo": "6222021234567890" },
  "bankInfo": { "bankName": "工商银行", "type": "借记卡" },
  "request_id": "log_78"
}

13. 银行卡归属地查询 apiyhkgsd

参数类型必填说明
cardnostring是银行卡号（6‑19 位数字）
curl "https://388377.xyz/API/apiyhkgsd.php?key=YOUR_API_KEY&cardno=6214830100960565"
{
  "success": true,
  "data": {
    "bank": "招商银行",
    "abbreviation": "CMB",
    "province": "北京",
    "city": "北京",
    "card_name": "银联IC普卡",
    "type": "借记卡",
    "card_bin": "621483",
    "card_digits": 16,
    "tel": "95555",
    "weburl": "www.cmbchina.com"
  },
  "request_id": "log_11"
}

14. 手机号基础信息 apisjhxx

参数类型必填说明
mobilestring是手机号（不支持 192）
curl "https://388377.xyz/API/apisjhxx.php?key=YOUR_API_KEY&mobile=13800138000"
{
  "success": true,
  "data": {
    "data": {
      "area": "北京-北京",
      "originalIsp": "移动",
      "newIsp": "移动",
      "isVirtuallyIsp": 0,
      "isTransfer": 0
    },
    "msg": "成功",
    "code": 200
  },
  "request_id": "log_2"
}

15. IP地址定位及附近 apiipdw

full模式扣2次，ip/nearby各扣1次。

参数类型必填说明
modestring否full / ip / nearby，默认full
ipstringfull/ip时必填公网IP
latfloatnearby时必填纬度
lngfloatnearby时必填经度
curl "https://388377.xyz/API/apiipdw.php?key=YOUR_API_KEY&ip=118.213.76.0&mode=full"
{
  "success": true,
  "data": {
    "ip": "118.213.76.0",
    "location": {
      "country": "中国",
      "region": "青海",
      "city": "西宁",
      "isp": "中国电信",
      "lat": "36.617144",
      "lng": "101.778228"
    },
    "nearby": {
      "formatted_address": "青海省西宁市城中区...",
      "pois": [
        { "title": "宝光·翡翠华庭", "_distance": 122.1 }
      ]
    }
  },
  "request_id": "log_92"
}

16. 三网停机次数查询 apitjcs

仅在上游返回有效数据时扣次数。

参数类型必填说明
mobilestring是手机号
curl "https://388377.xyz/API/apitjcs.php?key=YOUR_API_KEY&mobile=17527105558"
{
  "success": true,
  "data": {
    "is_sync": true,
    "message": "查询完成",
    "data": [
      { "mobile": "17527105558", "operator": "中国联通", "status": "(0,3]次" }
    ]
  },
  "request_id": "log_95"
}

17. 三网消费区间查询 apixfqj

仅在上游返回有效数据时扣次数。

参数类型必填说明
mobilestring是手机号
curl "https://388377.xyz/API/apixfqj.php?key=YOUR_API_KEY&mobile=13800138000"
{
  "success": true,
  "data": {
    "processed_count": 1,
    "success_count": 1,
    "total_cost": 3.00,
    "data": [
      { "mobile": "13800138000", "operator_name": "移动", "state_desc": "[50,100)元" }
    ]
  },
  "request_id": "log_98"
}

18. 三网在网时长查询 apizwsc

HTTP成功即扣费。不支持广电 192 号段。

参数类型必填说明
mobilestring是手机号（11 位，不支持 192）
curl "https://388377.xyz/API/apizwsc.php?key=YOUR_API_KEY&mobile=13800138000"
{
  "success": true,
  "data": {
    "mobile": "13800138000",
    "result": "5",
    "description": "24个月及以上（入网超过2年）",
    "channel": "移动",
    "time": "[24,+∞)"
  },
  "request_id": "log_123"
}

result 字段说明：

result含义
0查无此号或已注销
1[0,3)个月（入网不足3个月）
2[3,6)个月（入网3至6个月）
3[6,12)个月（入网6至12个月）
4[12,24)个月（入网1至2年）
524个月及以上（入网超过2年）

全局错误码

状态码错误码 (code)说明
401INVALID_KEY_FORMATAPI 密钥格式错误（需 32 位）
401INVALID_API_KEY密钥无效或已禁用
402INSUFFICIENT_CREDITS该服务剩余次数不足，请联系充值
403HTTPS_REQUIRED必须使用 HTTPS 访问
429RATE_LIMITED请求过于频繁
502UPSTREAM_SERVICE_ERROR上游服务异常，可重试
503UPSTREAM_NETWORK_ERROR网络连接失败
500INTERNAL_ERROR服务器内部错误

常见问题

如何获取 API Key？
联系客服开通账号，或通过 用户自助系统注册。
次数用完了怎么办？
加群联系群主充值（群号 311896953），对应服务的次数，秒级到账。
为什么返回 402？
该服务可用次数为 0，请及时充值。
request_id 有什么用？
每次调用生成的唯一 ID，反馈问题时提供此 ID 可快速定位日志。