基础信息

  • 开发环境基础URL: https://aw.chainfo.io/
  • 接口协议: HTTP/HTTPS
  • 数据格式: JSON
  • 字符编码: UTF-8

鉴权方式

Bearer Token 认证

  • 认证方式: Bearer Token
  • 请求头: Authorization: Bearer <token>

 

鉴权参数

参数名 类型 是否必填 描述
Authorization string 是 Bearer Token，用于接口访问权限验证

鉴权示例

Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...

注意事项

  • Token 需要在请求的 Header 中携带
  • Token 的有效期和获取方式请联系后端管理员
  • 无效或过期的 Token 将导致接口调用失败

 

接口总览

接口名称 路径 方法 描述
银行卡验证 /v1/blackcard/verify_card POST 验证银行卡信息
设备指纹查询 /v1/blackcard/device_fingerprint POST 查询设备指纹信息

接口详情

1. 黑卡验证接口

请求信息

  • 路径: /v1/blackcard/verify_card
  • 方法: POST
  • 描述: 验证银行卡信息的接口

 

请求参数

参数名 类型 是否必填 描述
bank string 是 银行卡号
name string 否 持卡人姓名
card string 否 身份证号码
phone string 否 预留手机号

请求参数示例

{
    "bank": "6214623121002319954",
    "name": "徐实",
    "card": "410105199108130056", 
    "phone": "13523550464"
}

响应参数

参数名 类型 是否必填 描述
code integer 是 响应状态码
msg string 是 响应消息
data object 是 响应数据
> status integer 是 业务状态码
> riskLabel array 是 风控明细
>> riskLabel string 否 风控标签：01 ：欺诈者，02：赌博庄家，03：赌徒，04：跑分者
>> riskLabelValue string 否 风控标签值，范围为 1-100，值越大风险越高；任意标签值大于50，则可认为是黑卡

code 状态码说明

状态码 含义 建议处理方式
0 请求成功 正常处理响应数据
1 信息不一致 提示用户检查输入信息
2 请求失败，未扣款 重试或联系客服

响应示例

{
    "code": 0,
    "msg": "请求成功",
    "data": {
        "status": 1,
        "riskLabel": [
            {
                "riskLabel": "02",
                "riskLabelValue": "0"
            },
            {
                "riskLabel": "04",
                "riskLabelValue": "10"
            },
            {
                "riskLabel": "01",
                "riskLabelValue": "56"
            },
            {
                "riskLabel": "03",
                "riskLabelValue": "5"
            }
        ]
    },
    "trace": ""
}

可能的错误码

错误码 描述
400 参数错误
401 验证失败
500 服务器内部错误

2. 设备指纹查询接口

请求信息

  • 路径: /v1/blackcard/device_fingerprint
  • 方法: POST
  • 描述: 查询设备指纹信息

 

请求参数

参数名 类型 是否必填 描述
fingerprint string 是 设备指纹标识

请求参数示例

{
    "fingerprint": "abc123def456"
}

响应参数

参数名 类型 是否必填 描述
code integer 是 响应状态码
msg string 是 响应消息
data object 是 响应数据
> fingerprint string 是 设备指纹信息
> status string 是 状态：success（成功）
> message string 是 提示信息

响应示例

{
    "code": 0,
    "msg": "查询成功",
    "data": {
        "fingerprint": "暂无指纹",
        "status": "success",
        "message": "成功"
    },
    "trace": ""
}

注意事项

  • fingerprint 参数为必填项

可能的错误码

错误码 描述
400 参数错误（缺少fingerprint参数）
500 服务器内部错误

附加说明

  • 所有接口默认使用 JSON 格式进行数据交换
  • 请求头需包含 Content-Type: application/json
  • 建议使用 HTTPS 协议

 

文档持续更新中…