API文档

基础信息

• 开发环境基础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	验证银行卡信息
待添加接口	–	–	–

接口详情

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	服务器内部错误

附加说明

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

文档持续更新中…