💎 为什么选择我们的 API
⚡
毫秒级查询本地号段库 + 索引优化，单号查询毫秒返回；批量接口单片万条🛡️
安全稳定Key 级鉴权、每秒限流、每日额度三重管控，参数白名单校验防注入📊
用量透明每次请求返回剩余额度，后台可查每个 Key 的调用明细，账目清晰🧰
多语言友好标准 HTTP + JSON，curl / Python / Java / JS 等任意语言均可接入📦 开放接口清单
鉴权方式：请求头携带 X-API-Key: 你的Key（或 URL 参数 api_key）。在线接口文档：https://www.0674.cn/openapi.php?action=help
| action | 能力 | 关键参数 |
|---|---|---|
phone.single | 手机号归属地单号查询（省/市/运营商/区号/邮编） | phone=11位手机号 |
phone.batch | 批量归属地查询（POST，单次≤10000条） | phones=逗号分隔号码，type=full/simple/isp |
phone.regions | 省份/城市/号段选项（筛选控件数据源） | 无 |
phone.meta | 号段元数据（随机生成的数据底座，≤5000条/次） | mode=all/isp/region/prefix 及对应筛选参数 |
hs.search | HS编码智能归类（按货物描述搜编码） | q=货物描述，country=国家（可空） |
hs.lookup | HS编码查询（含税率等扩展信息） | code=编码，country=国家（可空） |
gold.price | 实时金价（上金所全品种/国际贵金属/基准价/60日走势） | fresh=1 强制刷新 |
usage | 查询本 Key 用量与额度 | 无 |
返回格式：成功 {"ok":true,"data":{...}}，失败 {"ok":false,"code":"错误码","message":"说明"}。更多接口中，欢迎洽谈定制。
🧭 接入流程
- 洽谈合作
通过页面底部联系方式与我们联系，说明使用场景与预估调用量，确定套餐与额度。 - 获取 Key
开通后您将获得专属 API Key，每个 Key 独立限流与额度，互不影响。 - 发起请求
在请求头携带 X-API-Key 即可调用，参考下方示例代码。 - 上线运行
响应头 X-Quota-Remaining 实时返回今日剩余额度，额度次日自动恢复；如有扩容需求随时联系。
💰 合作方式
具体价格以洽谈为准，量越大单价越优惠。
💻 接入示例
curl
bash
curl 'https://www.0674.cn/openapi.php?action=phone.single&phone=13800138000' \
-H 'X-API-Key: 你的Key'Python
python
import requests
KEY = '你的Key'
BASE = 'https://www.0674.cn/openapi.php'
headers = {'X-API-Key': KEY}
# 单号查询
r = requests.get(BASE, params={'action': 'phone.single', 'phone': '13800138000'}, headers=headers)
print(r.json()) # {'ok': True, 'data': {'province': '北京', 'city': '北京', 'isp': '中国移动', ...}}
# 批量查询
r = requests.post(BASE, params={'action': 'phone.batch'},
data={'phones': '13800138000,13900139000', 'type': 'simple'},
headers=headers)
for row in r.json()['data']['rows']:
print(row['phone'], row['province'], row['city'], row['isp'])JavaScript（Node.js）
javascript
const KEY = '你的Key';
const BASE = 'https://www.0674.cn/openapi.php';
const resp = await fetch(`${BASE}?action=phone.single&phone=13800138000`, {
headers: { 'X-API-Key': KEY }
});
const data = await resp.json();
console.log(data); // { ok: true, data: { province: '北京', city: '北京', isp: '中国移动', ... } }PHP
php
$ch = curl_init('https://www.0674.cn/openapi.php?action=phone.single&phone=13800138000');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['X-API-Key: 你的Key'],
]);
$data = json_decode(curl_exec($ch), true);
print_r($data);提示：请勿把 Key 写在前端网页/小程序代码里（会被查看），生产环境请从您自己的后端转发调用。
🔍 错误码说明
| code | HTTP | 含义 |
|---|---|---|
missing_key | 401 | 未携带 Key |
invalid_key | 401 | Key 不存在或已删除 |
key_disabled | 403 | Key 已被停用 |
rate_limited | 429 | 触发限流（每 Key 每秒最多 20 次，批量每秒 5 次），稍后重试 |
quota_exceeded | 429 | 今日额度已用完，次日自动恢复 |
bad_request | 400 | 参数缺失或格式错误（message 中有具体说明） |
not_found | 404 | 无查询结果 |
server_error | 500 | 服务器内部错误，可重试 |
❓ 常见问题
数据准确吗？更新频率如何？
归属地按号段前 7 位匹配自建号段库，持续维护更新；金价数据来自公开行情源，分级缓存实时刷新；HS 编码库覆盖中国海关税则。特殊数据需求可洽谈定制。
额度用完了怎么办？
当日用完即返回 429（quota_exceeded），次日零点自动恢复。业务量增长可随时联系我们上调额度。
Key 泄露了怎么办？
立即联系我们，旧 Key 停用并换发新 Key，原调用方即时失效，安全可控。
支持批量/大并发调用吗？
批量接口单次最多 1 万条，大并发场景走企业定制方案（专属限流配置）。
为什么有些工具没有开放接口？
部分工具（如身份证、银行卡归属地）为纯前端计算，无后端数据接口，暂不开放。后续开放计划以洽谈沟通为准。
可以先试用再决定吗？
可以。联系我们说明场景，即可开通小额免费体验额度，验证效果后再谈正式合作。
🤝 开始合作
洽谈合作 / 申请试用 / 获取报价，欢迎随时联系
商务合作：54111