人脸卫士

企业专用

结合权威身份认证的精准人脸风险查询服务,提升人脸应用及身份认证生态的安全性。人脸风险情报库,覆盖范围广、准确性高,数据权威可靠。

  • 接口文档

    接口文档
  • 人脸风险查询

  • 错误码
  • 错误码列表
  • 资源下载
  • 接口文档下载
人脸风险查询
接口地址:http://apis.juhe.cn/face_guard/query
请求方式:http get/post
返回类型:json
接口描述:通过身份证和姓名查询人脸风险的攻击行为记录,查询时间为T-1,error_code=0的时候计费一次
接口调试: API测试工具

请求Header:

名称
  Content-Type application/x-www-form-urlencoded

请求参数说明:

名称 必填 类型 说明
  key string 接口请求key,在个人中心->数据中心->我的API进行查看
  idcard string 身份证号
  realname string 姓名

请求代码示例:

  • curl
  • PHP
  • Python
  • Go
  • C#
  • Node
  • Java
  • ObjectC
curl -k -i "http://apis.juhe.cn/face_guard/query?key=key&idcard=xxx&realname=xxx"

返回参数说明:

名称 类型 说明
  error_code int 返回码,为0时计费一次
  reason string 返回结果描述
  result object 返回结果集
  orderid string 流水号
  res string 结果码,error_code为0时的结果可能为:
0XX0,说明:身份信息匹配一致,未查询到记录。
0XX1,说明:身份信息匹配一致,查询到记录。
0XX5,说明:身份信息匹配一致,公安数据库异常。
5XXX,说明:身份信息匹配不一致
error_code为279799时可能为:
6XXX,说明:参数异常。
7XXX,说明:两项原子服务异常。
XXX3,说明:查询时间不合规。
XXX4,说明:调用超时。
XXX5,说明:其他错误。
XXXX,说明:系统异常
其余错误码不会出现此字段
  msg string 结果码说明
  data jsonObject 查询到的结果详情
仅当res为0XX1时会出现此字段
  idFlag string 查得标识为1
  idRiskItfinLasttime int 历史最晚发生攻击距今时间(天)
  idRisk1dItfinCnt int 近1天攻击数
  idRisk3dItfinCnt int 近3天攻击数
  idRisk7dItfinCnt int 近7天攻击数
  idRisk14dItfinCnt int 近14天攻击数
  idRisk30dItfinCnt int 近30天攻击数
  idRisk60dItfinCnt int 近60天攻击数
  idRisk120dItfinCnt int 近120天攻击数
  idRisk180dItfinCnt int 近180天攻击数
  idRisk1dItfinNightcnt double 近1天攻击中夜间(0点-6点)攻击比例
  idRisk3dItfinNightcnt double 近3天攻击中夜间(0点-6点)攻击比例
  idRisk7dItfinNightcnt double 近7天攻击中夜间(0点-6点)攻击比例
  idRisk14dItfinNightcnt double 近14天攻击中夜间(0点-6点)攻击比例
  idRisk30dItfinNightcnt double 近30天攻击中夜间(0点-6点)攻击比例
  idRisk60dItfinNightcnt double 近60天攻击中夜间(0点-6点)攻击比例
  idRisk120dItfinNightcnt double 近120天攻击中夜间(0点-6点)攻击比例
  idRisk180dItfinNightcnt double 近180天攻击中夜间(0点-6点)攻击比例

JSON返回示例:JSON在线格式化工具 >

      {
    "reason": "成功",
    "result": {
        "orderid": "JH797240703141527CoML0",
        "res": "0XX1",
        "msg": "身份信息匹配一致,查询到记录",
        "data": {
            "idFlag": "1",
            "idRisk120dItfinCnt": 3600,
            "idRisk120dItfinNightcnt": 0.1,
            "idRisk14dItfinCnt": 560,
            "idRisk14dItfinNightcnt": 0.11,
            "idRisk180dItfinCnt": 7200,
            "idRisk180dItfinNightcnt": 0.12,
            "idRisk1dItfinCnt": 80,
            "idRisk1dItfinNightcnt": 0.11,
            "idRisk30dItfinCnt": 120,
            "idRisk30dItfinNightcnt": 0.12,
            "idRisk3dItfinCnt": 120,
            "idRisk3dItfinNightcnt": 0.12,
            "idRisk60dItfinCnt": 2400,
            "idRisk60dItfinNightcnt": 0.98,
            "idRisk7dItfinCnt": 280,
            "idRisk7dItfinNightcnt": 0.93,
            "idRiskItfinLasttime": 2
        }
    },
    "error_code": 0
}

---------------------------------------------------------------------
{
    "reason": "成功",
    "result": {
        "orderid": "JH797240703141527CoML0",
        "res": "0XX0",
        "msg": "身份信息匹配一致,未查询到记录"
    },
    "error_code": 0
}
---------------------------------------------------------------
{
    "reason": "成功",
    "result": {
        "orderid": "JH797240703141527CoML0",
        "res": "5XXX",
        "msg": "身份信息匹配不一致"
    },
    "error_code": 0
}

服务级错误码参照(error_code):

  错误码 说明
  279701 任意参数不能为空
  279702 姓名格式错误
  279703 身份证格式错误
  279799 失败

系统级错误码参照:

  错误码 说明 旧版本(resultcode)
  10001 错误的请求KEY 101
  10002 该KEY无请求权限 102
  10003 KEY过期 103
  10004 错误的OPENID 104
  10005 应用未审核超时,请提交认证 105
  10007 未知的请求源 107
  10008 被禁止的IP 108
  10009 被禁止的KEY 109
  10011 当前IP请求超过限制 111
  10012 请求超过次数限制 112
  10013 测试KEY超过请求限制 113
  10014 系统内部异常(调用充值类业务时,请务必联系客服或通过订单查询接口检测订单,避免造成损失) 114
  10020 接口维护 120
  10021 接口停用 121

错误码格式说明(示例:200201):

  2 002 01
  服务级错误(1为系统级错误) 服务模块代码(即数据ID) 具体错误代码
人脸卫士
9
申请次数
797
ID
1
收藏次数

推荐API

  • 全球天气预报

    支持全球约2.4万个城市地区天气查询,如:天气实况、逐日天气预报、24小时历史天气等
  • 购物小票识别

    支持识别各类商场、超市及药店的购物小票,包括店名、单号、总金额、消费时间、明细商品名称、单价、数量、金额等信息,可用于商品售卖信息统计、购物中心用户积分兑换及企业内部报销等场景
  • 涉农贷款地址识别

    涉农贷款地址识别,支持对私和对公两种方式。输入地址的行政区划越完整,识别准确度越高。
  • 人脸四要素

    根据给定的手机号、姓名、身份证、人像图片核验是否一致
  • 个人/企业涉诉查询

    通过企业关键词查询企业涉讼详情,如裁判文书、开庭公告、执行公告、失信公告、案件流程等等。

API资讯

数 据 驱 动 未 来
Data Drives The Future
0512-88869195
数 据 驱 动 未 来
Data Drives The Future