简要描述:
- 开发人员在拉普后台设置回调地址(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 作者:长喜