400-6622-111 登录 注册

飞鸽API文档

API:人像比对

采用 HTTP POST 请求模式， 飞鸽API 该接口可以根据人脸照片以及身份证基本信息与权威数据相比，获得比对结果。

请求URL

https://data.4321.sh/factor/faceauth

请求参数

  • 参数 类型 是否可空 默认 描述
  • apikey
    string
    N
    无
    身份认证产品Api接口账号
  • secret
    string
    N
    无
    身份认证产品Api接口秘钥
  • name
    string
    N
    无
    姓名
  • id_card
    string
    N
    无
    身份证
  • face
    string
    N
    无
    人脸照，base64字符串，图片大小不能大于100K，base64字符串去掉头部描述(如data:image/png;base64,)

协议

HTTP POST

编码格式

UTF-8

Content-Type

application/json

是否需要授权

是

参阅 API 授权和验证机制

错误代码

参阅 API 错误代码

返回值格式

json默认

{
 "data": {
 "result": "01",
 "id_card_result": "身份证核验结果",
 "id_card_message": "身份证核验结果说明",
 "photo_result": "图像结果",
 "photo_message": "图像结果说明"
 },
 "fee":0.3,
 "code": 0,
 "msg": "OK"
}

返回值参数说明

  • 参数 描述 示例
  • data
    返回对象
    返回对象
  • result
    返回结果 01-认证一致(收费) 02-认证不一致(收费) 04-认证失败(不收费)
    01
  • id_card_result
    身份证核验结果
    01--一致 02--不一致 04--认证失败
  • id_card_message
    身份证核验结果说明
  • photo_result
    图像结果
    01--判断为同一人 02--判断不是同一人 03--不能确定是否为同一人 04--认证失败 05--身份校验未通过 06--库中无照片 07--图片质量不合格 08--库中无此号 09-无法验证
  • photo_message
    图像结果说明
  • fee
    认证费用
    0.3
  • code
    接口回执状态码，判断成功失败的标志
  • msg
    接口回执状态描述