开发文档

开发文档

请求规范、鉴权方式与接口说明。

1. 概述

数字会员在网页下单。本页说明数据接口的调用方式,包括实名比对、车辆、工商、手机号、域名和物流等。说明使用场景后,由客服开通接口权限。

2. 快速开始

  1. 注册账户
  2. 在控制台「API Key 与套餐」复制 Key
  3. 提交接口开通申请,核实后开通
  4. 按下文发起请求

3. 接入地址

正式环境https://sowk.xingsuqy.com/v1
协议HTTPS
编码UTF-8
数据格式JSON

4. 鉴权

X-API-Key: xs_xxx

Key 泄露请在控制台重置。仅在服务端保存和使用,不要在前端代码中使用。

5. 公共请求头

请求头必填说明
X-API-Key是控制台 API Key,仅在服务端保存
Content-TypePOST 时是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 用于问题排查。

字段说明
code0 表示请求成功
message响应说明
request_id请求追踪标识
data接口返回的业务数据

8. 错误码表

codeHTTP说明处理建议
0200成功—
400400参数缺失或格式错误检查 message 指出的参数
401401API Key 缺失或无效在控制台核对 Key
1002402该接口无可用次数联系客服开通
1003403该接口未对当前账户开通联系客服开通
404404接口不存在核对接口编号
429429超出频率限制按 Retry-After 重试
500500服务内部错误携 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-2ePOST/v1/query/id-2e¥0.022 / 次详情
人脸实名认证id-facePOST/v1/query/id-face¥0.142 / 次详情
银行卡要素核验id-bankPOST/v1/query/id-bank¥0.19 / 次详情
手机号二要素认证id-phone2POST/v1/query/id-phone2¥0.162 / 次详情
手机号三要素认证id-phone3POST/v1/query/id-phone3¥0.14 / 次详情

交通与车辆

接口名编号方法请求路径单价文档
车牌五项信息查询vh-plate5POST/v1/query/vh-plate5¥0.42 / 次详情
车牌解析车辆信息vh-platePOST/v1/query/vh-plate¥0.43 / 次详情
VIN 车架号解析vh-vinPOST/v1/query/vh-vin¥0.042 / 次详情
VIN 反查车牌vh-vin-platePOST/v1/query/vh-vin-plate¥0.40 / 次详情
人车关系核验vh-ownerPOST/v1/query/vh-owner¥1.80 / 次详情
人车 ETC 关系核验vh-etcPOST/v1/query/vh-etc¥1.30 / 次详情
车辆过户次数查询vh-transferPOST/v1/query/vh-transfer¥3.00 / 次详情
车辆上险信息查询vh-insurePOST/v1/query/vh-insure¥1.80 / 次详情
名下车辆数量查询vh-countPOST/v1/query/vh-count¥4.00 / 次详情
车牌归属地查询vh-regionPOST/v1/query/vh-region免费详情

企业工商

接口名编号方法请求路径单价文档
企业名称模糊查询en-namePOST/v1/query/en-name¥0.12 / 次详情
企业工商信息检索en-searchPOST/v1/query/en-search¥0.12 / 次详情
企业工商信息标准查询en-stdPOST/v1/query/en-std¥0.18 / 次详情
企业任职记录查询en-jobPOST/v1/query/en-job¥1.00 / 次详情

手机号码

接口名编号方法请求路径单价文档
手机号码归属地mo-geoPOST/v1/query/mo-geo¥0.0001 / 次详情
手机号在网状态mo-statusPOST/v1/query/mo-status¥0.0043 / 次详情
手机号在网时长mo-agePOST/v1/query/mo-age¥0.30 / 次详情
手机话费余额查询mo-balancePOST/v1/query/mo-balance¥0.089 / 次详情
身份证号归属地mo-idgeoPOST/v1/query/mo-idgeo¥0.002 / 次详情

网站域名

接口名编号方法请求路径单价文档
ICP 备案实时查询dm-icpPOST/v1/query/dm-icp¥0.02 / 次详情
主办单位备案查询dm-orgPOST/v1/query/dm-org¥0.04 / 次详情
域名 WHOIS 查询dm-whoisPOST/v1/query/dm-whois¥0.018 / 次详情
SSL 证书查询dm-sslPOST/v1/query/dm-ssl¥0.0195 / 次详情
QQ 域名拦截查询dm-qqPOST/v1/query/dm-qq¥0.0023 / 次详情
微信域名拦截查询dm-wxPOST/v1/query/dm-wx¥0.0023 / 次详情
网站标题与描述查询dm-tdkPOST/v1/query/dm-tdk免费详情

金融风险

接口名编号方法请求路径单价文档
失信被执行人查询fn-creditPOST/v1/query/fn-credit¥0.40 / 次详情
限制高消费查询fn-limitPOST/v1/query/fn-limit¥0.09 / 次详情
司法综合数据查询fn-lawPOST/v1/query/fn-law¥0.30 / 次详情

生活服务

接口名编号方法请求路径单价文档
短信验证码发送lf-smsPOST/v1/query/lf-sms¥0.038 / 次详情
邮件代发送lf-mailPOST/v1/query/lf-mail¥0.001 / 次详情
快递物流查询lf-expressPOST/v1/query/lf-express¥0.0035 / 次详情
IP 归属地查询lf-ipPOST/v1/query/lf-ip免费详情
银行卡归属地lf-bankgeoPOST/v1/query/lf-bankgeo¥0.005 / 次详情
人民币汇率查询lf-fxPOST/v1/query/lf-fx¥0.0013 / 次详情
文档转 PDFlf-pdfPOST/v1/query/lf-pdf¥0.01 / 次详情
敏感词检测lf-ocrPOST/v1/query/lf-ocr¥0.006 / 次详情
图片内容审核lf-imgPOST/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

提交反馈