大数据查询

提供多维度、多数据源的大数据查询与检索能力，支持身份核验、反欺诈、风险画像等场景。

所有接口均需在请求头中携带：Authorization: Basic {Base64(appId:密钥)}

---

1. 统一大数据查询（推荐）

通过统一入口传入查询类型与参数，获取标准化查询结果。

请求说明

项目	说明
请求方式	POST
请求地址	/api/bigdata/query
Content-Type	application/json

请求参数

参数名	类型	必填	说明
queryType	string	是	查询类型：IDENTITY / ANTI_FRAUD / RISK_PORTRAIT / BEHAVIOR / CUSTOM
requestId	string	是	本次请求唯一标识，用于对账与幂等
data	object	是	查询条件，根据 queryType 不同结构不同，见下表

data 按 queryType 说明

IDENTITY（身份核验）

参数名	类型	必填	说明
name	string	是	姓名
idNo	string	是	证件号
mobile	string	否	手机号（三要素时可填）

ANTI_FRAUD（反欺诈）

参数名	类型	必填	说明
name	string	否	姓名
idNo	string	否	证件号
mobile	string	否	手机号
ip	string	否	IP 地址
deviceId	string	否	设备 ID

RISK_PORTRAIT（风险画像）

参数名	类型	必填	说明
idNo	string	是	证件号或企业信用代码
idType	string	否	PERSON / ENTERPRISE

请求示例（身份核验）

POST /api/bigdata/query HTTP/1.1
Host: api.example.com
Content-Type: application/json
Authorization: Basic {Base64(appId:密钥)}

{
  "queryType": "IDENTITY",
  "requestId": "BD202402090001",
  "data": {
    "name": "张三",
    "idNo": "110101199001011234",
    "mobile": "13800138000"
  }
}

响应参数（通用）

参数名	类型	说明
code	int	状态码
data.requestId	string	与请求一致
data.queryType	string	查询类型
data.result	object	查询结果，结构随 queryType 不同
data.queryTime	string	查询时间
msg	string	提示信息

响应示例（身份核验）

{
  "code": 0,
  "data": {
    "requestId": "BD202402090001",
    "queryType": "IDENTITY",
    "result": {
      "match": true,
      "message": "身份信息一致",
      "nameMatch": true,
      "idNoMatch": true,
      "mobileMatch": true
    },
    "queryTime": "2024-02-09 16:00:00"
  },
  "msg": "success"
}

响应示例（反欺诈）

{
  "code": 0,
  "data": {
    "requestId": "BD202402090002",
    "queryType": "ANTI_FRAUD",
    "result": {
      "riskLevel": "LOW",
      "riskScore": 15,
      "tags": [],
      "suggestion": "风险较低，可正常受理"
    },
    "queryTime": "2024-02-09 16:01:00"
  },
  "msg": "success"
}

---

2. 批量查询

支持单次请求批量提交多条查询，适用于大批量核验场景。

请求说明

项目	说明
请求方式	POST
请求地址	/api/bigdata/batch
Content-Type	application/json

请求参数

参数名	类型	必填	说明
batchId	string	是	批次号，您系统内唯一
queryType	string	是	同「统一大数据查询」
items	array	是	查询项列表，单次最多 100 条
items[].requestId	string	是	单条请求 ID
items[].data	object	是	单条查询条件

请求示例

POST /api/bigdata/batch HTTP/1.1
Host: api.example.com
Content-Type: application/json
Authorization: Basic {Base64(appId:密钥)}

{
  "batchId": "BATCH202402090001",
  "queryType": "IDENTITY",
  "items": [
    {
      "requestId": "BD202402090101",
      "data": {
        "name": "张三",
        "idNo": "110101199001011234"
      }
    },
    {
      "requestId": "BD202402090102",
      "data": {
        "name": "李四",
        "idNo": "110101199002022345"
      }
    }
  ]
}

响应示例

{
  "code": 0,
  "data": {
    "batchId": "BATCH202402090001",
    "total": 2,
    "successCount": 2,
    "results": [
      {
        "requestId": "BD202402090101",
        "match": true,
        "message": "身份信息一致"
      },
      {
        "requestId": "BD202402090102",
        "match": true,
        "message": "身份信息一致"
      }
    ]
  },
  "msg": "success"
}

---

查询类型与计费说明

queryType	说明	备注
IDENTITY	身份核验（二要素/三要素）	按次计费
ANTI_FRAUD	反欺诈	按次计费
RISK_PORTRAIT	风险画像	按次计费
BEHAVIOR	行为数据查询	以实际开通为准
CUSTOM	自定义维度	需单独签约

具体计费与限流以接入协议为准。如有疑问请联系澄心科技技术支持。