接口列表

本页详细说明了 API 调用规范，涵盖完整的参数定义、字段类型及标准响应示例。

请求方式：GET (所有接口)
接口地址：https://sgkapi.dev
鉴权方式：URL Query 参数 (token)
模糊未知位可用 [- x *] 代替

综合查询

根据任意关键词检索全库匹配数据。

接口路径：/search

参数名	类型	必填	描述	示例
token	String	True	访问密钥	423C2E3D
query	String	True	任意关键词	18819163741

请求示例：

# 按手机检索
GET /search?token=423C2E3D&query=18819163741

# 按地址检索
GET /search?token=423C2E3D&query=街道办事处云山村委会6组

响应示例：

{
  "status": "success",
  "message": "数据获取成功",
  "data": [
    {
      "数据来源": "「SGKAPI - 免费公测」",
      "姓名": "李燕霞",
      "证件": "430426198409168725",
      "出生": "湖南省衡阳市祁东县",
      "生日": "1984年9月16日",
      "年龄": "42",
      "性别": "女",
      "生肖": "子鼠",
      "星座": "处女座",
      "手机": "18819163741",
      "归属": "广东广州;中国移动"
    },
    ...
  ],
  "total": 5
}

模糊补齐

输入模糊或精确信息，自动补全完整数据。

Tips：三个参数可任意组合，必须至少组合两个。

接口路径：/complete

参数名	类型	必填	描述	示例
token	String	True	访问密钥	423C2E3D
name	String	False	精确/模糊姓名	李*霞
cardno	String	False	精确/模糊证件	430426****09168725
mobile	String	False	精确/模糊手机	188****3741

请求示例：

# 按姓名-证件补齐
GET /complete?token=423C2E3D&name=李*霞&cardno=430426****09168725

# 按姓名-手机补齐
GET /complete?token=423C2E3D&name=李*霞&mobile=188****3741

# 按证件-手机补齐
GET /complete?token=423C2E3D&cardno=430426****09168725&mobile=188****3741

# 按姓名-证件-手机补齐
GET /complete?token=423C2E3D&name=李*霞&cardno=430426****09168725&mobile=188****3741

响应示例：

{
  "status": "success",
  "message": "数据获取成功",
  "data": [
    "李燕霞 430426198409168725"
  ],
  "total": 1
}

证件猎魔

结合多维身份特征，自动推演完整信息。

Tips：年龄参数与年份范围参数不可同时提交。

接口路径：/advanced_c

参数名	类型	必填	描述	示例
token	String	True	访问密钥	423C2E3D
name	String	True	精确/模糊姓名	李燕霞
region	String	True	目标地区	祁东县
gender	String	True	目标性别	女
age	String	False	目标年龄	42
start_year	String	False	开始年份	1980
end_year	String	False	结束年份	1985
zodiac	String	False	目标生肖	子鼠
sign	String	False	目标星座	处女座

请求示例：

# 按姓名-地区-性别猎魔
GET /advanced_c?token=423C2E3D&name=李燕霞&region=祁东县&gender=女

# 按姓名-地区-性别-年份范围猎魔
GET /advanced_c?token=423C2E3D&name=李燕霞&region=祁东县&gender=女&start_year=1980&end_year=1985

# 按姓名-地区-性别-生肖-星座猎魔
GET /advanced_c?token=423C2E3D&name=李燕霞&region=祁东县&gender=女&zodiac=子鼠&sign=处女座

响应示例：

{
  "status": "success",
  "message": "数据获取成功",
  "data": [
    "李燕霞 430426198409168725"
  ],
  "total": 1
}

手机猎魔

结合多维身份特征，自动推演完整信息。

接口路径：/advanced_m

参数名	类型	必填	描述	示例
token	String	True	访问密钥	423C2E3D
name	String	True	精确/模糊姓名	李*霞
mobile	String	True	精确/模糊手机	188****3741
region	String	True	手机归属地	广州
carrier	String	False	手机运营商	中国移动

请求示例：

# 按姓名-手机-归属地猎魔
GET /advanced_m?token=423C2E3D&name=李*霞&mobile=188****3741&region=广州

# 按姓名-手机-归属地-运营商猎魔
GET /advanced_m?token=423C2E3D&name=李*霞&mobile=188****3741&region=广州&carrier=中国移动

响应示例：

{
  "status": "success",
  "message": "数据获取成功",
  "data": [
    "李燕霞 18819163741"
  ],
  "total": 1
}

响应格式

有结果响应：

{
  "status": "success",
  "message": "数据获取成功",
  "data": [
    "李燕霞 430426198409168725"
  ],
  "total": 1
}

无结果响应：

{
  "status": "success",
  "message": "数据获取成功",
  "data": [],
  "total": 0
}

内部错误响应：

{
  "status": "error",
  "message": "服务暂时不可用",
  "data": [],
  "total": 0
}

参数错误响应：

{
  "status": "error",
  "message": "缺少必要的参数"
}