简要描述:

  • 开发人员在拉普后台设置回调地址(https://laplace.shargoodata.com),
  • 登录账号与之前注册账号相同;
  • 应用场景为平台产品如商家的用户人脸核身完成后,学谷平台主动推送对应业务的使用情况和最终处理结果到对应的接口;
  • 通知结果的参数已标准化:要求商户接口输出success,fail 或其他字符串标记

适用学谷产品:

序号 产品名称 产品ID-ServiceName 说明
1 人脸核身MP_3.0 real_verify_live_detect_mp_v3
2 人脸活体MP_3.0 face_live_detect_mp_v3
3 人脸核身Plugin_3.0 real_verify_live_detect_plugin_v3
4 人脸活体Plugin_3.0 face_live_detect_plugin_v3

回调请求URL示例:

接口地址:https://{your_api_domain}/v1/callbackShargoo/callback
请求方式:POST
数据类型:json

请求头:

Content-Type:application/json

维护回调地址:

通过https://laplace.shargoodata.com/ 拉普后台,开发管理中维护回调地址

回调结果:

参数名 是否必须 类型 说明
code int 0成功,其他为异常
msg string 结果说明
result map 返回结构体
result.biz string 对应各产品服务接口的serviceName,例:real_verify_live_detect_mp_v3
result.orderNo string 商户端自定义认证记录唯一编号
result.state bool 处理结果

通知示例:

正确时推送内容:

{
    "result":{"biz":"real_verify_live_detect_mp_v3","orderNo":"Abc20230101000101","state":true}
    "msg":"成功",
    "code":0
}

错误时推送:

{
    "result":{},
    "msg":"校验失败,照片不清晰",
    "code":1
}

商户接口返回

fail 表示失败
success 表示成功

学谷端只推送一次,如有失败可重新认证

文档更新时间: 2025-08-11 14:10   作者:长喜