1. 概述
数字会员在网页下单。本页说明数据接口的调用方式,包括实名比对、车辆、工商、手机号、域名和物流等。说明使用场景后,由客服开通接口权限。
2. 快速开始
- 注册账户
- 在控制台「API Key 与套餐」复制 Key
- 提交接口开通申请,核实后开通
- 按下文发起请求
3. 接入地址
| 正式环境 | https://sowk.xingsuqy.com/v1 |
|---|---|
| 协议 | HTTPS |
| 编码 | UTF-8 |
| 数据格式 | JSON |
4. 鉴权
X-API-Key: xs_xxx
Key 泄露请在控制台重置。仅在服务端保存和使用,不要在前端代码中使用。
5. 公共请求头
| 请求头 | 必填 | 说明 |
|---|---|---|
| X-API-Key | 是 | 控制台 API Key,仅在服务端保存 |
| Content-Type | POST 时是 | application/json |
| X-Request-Id | 否 | 客户端追踪 ID,1–64 个字母、数字、下划线或短横线;有效时原样回传,否则自动生成 |
6. 请求规范
数据接口使用 POST,请求头为 Content-Type: application/json,body 为 JSON 对象。参数名区分大小写,客户端单次请求超时建议设为 10 秒。
7. 响应规范
{
"code": 0,
"message": "success",
"request_id": "20260919120000abc123",
"data": {}
}code=0 表示成功,其余见错误码。request_id 用于问题排查。
| 字段 | 说明 |
|---|---|
| code | 0 表示请求成功 |
| message | 响应说明 |
| request_id | 请求追踪标识 |
| data | 接口返回的业务数据 |
8. 错误码表
| code | HTTP | 说明 | 处理建议 |
|---|---|---|---|
| 0 | 200 | 成功 | — |
| 400 | 400 | 参数缺失或格式错误 | 检查 message 指出的参数 |
| 401 | 401 | API Key 缺失或无效 | 在控制台核对 Key |
| 1002 | 402 | 该接口无可用次数 | 联系客服开通 |
| 1003 | 403 | 该接口未对当前账户开通 | 联系客服开通 |
| 404 | 404 | 接口不存在 | 核对接口编号 |
| 429 | 429 | 超出频率限制 | 按 Retry-After 重试 |
| 500 | 500 | 服务内部错误 | 携 request_id 联系客服 |
9. 频率限制
鉴权前每 IP 120 次/分钟;鉴权后每账户 60 次/分钟。超限返回 429 与 Retry-After。
10. 计费规则
接口由客服审核使用场景后开通,开通后按实际调用次数结算。未开通、未付款时不产生费用。套餐次数不设有效期。
11. 账户接口
curl https://sowk.xingsuqy.com/v1/account -H "X-API-Key: xs_your_key"
{
"code": 0,
"message": "success",
"request_id": "20260919120000abc123",
"data": {
"email": "t***@xingsuqy.com",
"username": "xingsu_dev",
"packages": [
{
"api": "id-2e",
"name": "身份证实名核验",
"calls": 1000
}
]
}
}12. 接口列表
实名认证
| 接口名 | 编号 | 方法 | 请求路径 | 单价 | 文档 |
|---|---|---|---|---|---|
| 身份证实名核验 | id-2e | POST | /v1/query/id-2e | ¥0.022 / 次 | 详情 |
| 人脸实名认证 | id-face | POST | /v1/query/id-face | ¥0.142 / 次 | 详情 |
| 银行卡要素核验 | id-bank | POST | /v1/query/id-bank | ¥0.19 / 次 | 详情 |
| 手机号二要素认证 | id-phone2 | POST | /v1/query/id-phone2 | ¥0.162 / 次 | 详情 |
| 手机号三要素认证 | id-phone3 | POST | /v1/query/id-phone3 | ¥0.14 / 次 | 详情 |
交通与车辆
| 接口名 | 编号 | 方法 | 请求路径 | 单价 | 文档 |
|---|---|---|---|---|---|
| 车牌五项信息查询 | vh-plate5 | POST | /v1/query/vh-plate5 | ¥0.42 / 次 | 详情 |
| 车牌解析车辆信息 | vh-plate | POST | /v1/query/vh-plate | ¥0.43 / 次 | 详情 |
| VIN 车架号解析 | vh-vin | POST | /v1/query/vh-vin | ¥0.042 / 次 | 详情 |
| VIN 反查车牌 | vh-vin-plate | POST | /v1/query/vh-vin-plate | ¥0.40 / 次 | 详情 |
| 人车关系核验 | vh-owner | POST | /v1/query/vh-owner | ¥1.80 / 次 | 详情 |
| 人车 ETC 关系核验 | vh-etc | POST | /v1/query/vh-etc | ¥1.30 / 次 | 详情 |
| 车辆过户次数查询 | vh-transfer | POST | /v1/query/vh-transfer | ¥3.00 / 次 | 详情 |
| 车辆上险信息查询 | vh-insure | POST | /v1/query/vh-insure | ¥1.80 / 次 | 详情 |
| 名下车辆数量查询 | vh-count | POST | /v1/query/vh-count | ¥4.00 / 次 | 详情 |
| 车牌归属地查询 | vh-region | POST | /v1/query/vh-region | 免费 | 详情 |
企业工商
| 接口名 | 编号 | 方法 | 请求路径 | 单价 | 文档 |
|---|---|---|---|---|---|
| 企业名称模糊查询 | en-name | POST | /v1/query/en-name | ¥0.12 / 次 | 详情 |
| 企业工商信息检索 | en-search | POST | /v1/query/en-search | ¥0.12 / 次 | 详情 |
| 企业工商信息标准查询 | en-std | POST | /v1/query/en-std | ¥0.18 / 次 | 详情 |
| 企业任职记录查询 | en-job | POST | /v1/query/en-job | ¥1.00 / 次 | 详情 |
手机号码
| 接口名 | 编号 | 方法 | 请求路径 | 单价 | 文档 |
|---|---|---|---|---|---|
| 手机号码归属地 | mo-geo | POST | /v1/query/mo-geo | ¥0.0001 / 次 | 详情 |
| 手机号在网状态 | mo-status | POST | /v1/query/mo-status | ¥0.0043 / 次 | 详情 |
| 手机号在网时长 | mo-age | POST | /v1/query/mo-age | ¥0.30 / 次 | 详情 |
| 手机话费余额查询 | mo-balance | POST | /v1/query/mo-balance | ¥0.089 / 次 | 详情 |
| 身份证号归属地 | mo-idgeo | POST | /v1/query/mo-idgeo | ¥0.002 / 次 | 详情 |
网站域名
| 接口名 | 编号 | 方法 | 请求路径 | 单价 | 文档 |
|---|---|---|---|---|---|
| ICP 备案实时查询 | dm-icp | POST | /v1/query/dm-icp | ¥0.02 / 次 | 详情 |
| 主办单位备案查询 | dm-org | POST | /v1/query/dm-org | ¥0.04 / 次 | 详情 |
| 域名 WHOIS 查询 | dm-whois | POST | /v1/query/dm-whois | ¥0.018 / 次 | 详情 |
| SSL 证书查询 | dm-ssl | POST | /v1/query/dm-ssl | ¥0.0195 / 次 | 详情 |
| QQ 域名拦截查询 | dm-qq | POST | /v1/query/dm-qq | ¥0.0023 / 次 | 详情 |
| 微信域名拦截查询 | dm-wx | POST | /v1/query/dm-wx | ¥0.0023 / 次 | 详情 |
| 网站标题与描述查询 | dm-tdk | POST | /v1/query/dm-tdk | 免费 | 详情 |
金融风险
| 接口名 | 编号 | 方法 | 请求路径 | 单价 | 文档 |
|---|---|---|---|---|---|
| 失信被执行人查询 | fn-credit | POST | /v1/query/fn-credit | ¥0.40 / 次 | 详情 |
| 限制高消费查询 | fn-limit | POST | /v1/query/fn-limit | ¥0.09 / 次 | 详情 |
| 司法综合数据查询 | fn-law | POST | /v1/query/fn-law | ¥0.30 / 次 | 详情 |
生活服务
| 接口名 | 编号 | 方法 | 请求路径 | 单价 | 文档 |
|---|---|---|---|---|---|
| 短信验证码发送 | lf-sms | POST | /v1/query/lf-sms | ¥0.038 / 次 | 详情 |
| 邮件代发送 | lf-mail | POST | /v1/query/lf-mail | ¥0.001 / 次 | 详情 |
| 快递物流查询 | lf-express | POST | /v1/query/lf-express | ¥0.0035 / 次 | 详情 |
| IP 归属地查询 | lf-ip | POST | /v1/query/lf-ip | 免费 | 详情 |
| 银行卡归属地 | lf-bankgeo | POST | /v1/query/lf-bankgeo | ¥0.005 / 次 | 详情 |
| 人民币汇率查询 | lf-fx | POST | /v1/query/lf-fx | ¥0.0013 / 次 | 详情 |
| 文档转 PDF | lf-pdf | POST | /v1/query/lf-pdf | ¥0.01 / 次 | 详情 |
| 敏感词检测 | lf-ocr | POST | /v1/query/lf-ocr | ¥0.006 / 次 | 详情 |
| 图片内容审核 | lf-img | POST | /v1/query/lf-img | ¥0.012 / 次 | 详情 |
13. 数字会员目录接口
curl https://sowk.xingsuqy.com/v1/catalog -H "X-API-Key: xs_your_key"
返回在售数字会员的第一页,每页 12 个,包含编号、名称、分类、规格与价格。下单在网页完成。接口套餐不在此目录中。
14. 代码示例
cURL
curl -X POST https://sowk.xingsuqy.com/v1/query/id-2e \
-H "X-API-Key: xs_your_key" \
-H "Content-Type: application/json" \
-d '{"name":"张*","idcard":"110101********1234"}'PHP
<?php
$ch = curl_init('https://sowk.xingsuqy.com/v1/query/id-2e');
curl_setopt_array($ch, [
CURLOPT_POST => true,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_TIMEOUT => 10,
CURLOPT_HTTPHEADER => ["X-API-Key: xs_your_key", "Content-Type: application/json"],
CURLOPT_POSTFIELDS => json_encode(["name" => "张*", "idcard" => "110101********1234"], JSON_UNESCAPED_UNICODE),
]);
$result = curl_exec($ch);
if ($result === false) { throw new RuntimeException(curl_error($ch)); }
echo $result;
curl_close($ch);Python
import requests
response = requests.post("https://sowk.xingsuqy.com/v1/query/id-2e",
headers={"X-API-Key": "xs_your_key"},
json={"name": "张*", "idcard": "110101********1234"}, timeout=10)
print(response.status_code, response.json())Node
const response = await fetch("https://sowk.xingsuqy.com/v1/query/id-2e", {
method: "POST",
headers: {"X-API-Key": "xs_your_key", "Content-Type": "application/json"},
body: JSON.stringify({name: "张*", idcard: "110101********1234"}),
signal: AbortSignal.timeout(10000)
});
console.log(response.status, await response.json());15. 技术支持
客服 QQ 2840251932 · 服务时间 12:00–24:00
提交反馈