底签状态核验接口
一、接口描述
1. 功能描述
底签状态核验接口的主要功能为:检验用户输入的图片是否为茅台外盒的底部,若不是,则直接返回相应状态。若是,则进一步核验底签状态是否完整,返回核验结果。
2. 能力说明:
底签状态核验接口集成了茅台外盒底部识别和溯源码完整性识别两项技术能力。
- 茅台外盒底部识别:检验用户输入图像的区域是否为茅台外盒底部;
- 底签完整性核验:检查用户输入的图片中底签是否完整。
3. 接口数据要求:
- 输入图片格式:Base64(原始图片格式为jpg,RGB三通道图像);
- 图像尺寸:输入图像的宽和高均不低于512,且均不大于2048。
4. 接口使用:
平台为每个API提供试用体验服务,您在AI市场选择“免费试用”规格下单后,即可开始体验业内领先的人工智能API服务。 免费试用服务具有调用量、QPS限制,如需更高性能的API服务,可以提交咨询工单,联系京东AI扩容购买。
在获得使用权限后,您可使用已经封装好的SDK/参照接口鉴权规则进行相应开发,整体流程详见 接入流程
二、请求说明
1. 接口地址 :
https://aiapi.jd.com/jdai/moutai_bottom_label_check
2. 请求说明
(1) 请求方式:
post
(2) 请求参数
(a)query请求参数
公共请求参数
名称 | 类型 | 必填 | 示例值 | 描述 |
---|---|---|---|---|
appkey | string | 是 | 80d2b762ecb86593f9668526920f46c | 您的appkey,可在买家中心控制台中获取 |
timestamp | long | 是 | 1541491668060 | 请求的时间戳,精确到毫秒,timestamp有效期5分钟 |
sign | string | 是 | 2e148773a0337a8f2200ba90d445f083 | 签名,根据规则MD5(sectetkey+timestamp), |
(b)header请求参数
业务请求参数
名称 | 类型 | 必填 | 示例值 | 描述 |
---|---|---|---|---|
Content-Type | string | 是 | application/json | 标准json格式 |
(c)body请求参数
业务请求参数
名称 | 类型 | 必填 | 示例值 | 描述 |
---|---|---|---|---|
img_base64 | string | 是 | 图像Base64编码值,去掉图片头"data:image/jpg;base64,",img_base64=iVBORw0K...(由于过长,不给出完整示例) | 图像的Base64编码 |
request_id | string | 是 | "2c20715b-cfde-4048-96d3-fe831b5c80d1" | 请求ID,前端请求时生成的用于标识此次请求的UUID |
(3) 请求代码示例
建议您使用我们提供的SDK进行调用,SDK获取及调用方式详见本页接口描述中的4.接口试用
三、返回说明
1. 返回参数
(1)公共返回参数
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
code | string | 1000 | 参见下方错误码-系统级错误码 |
charge | boolean | false 或 true | false:不扣费, true:扣费 |
remainTimes | long | 1305 | 剩余调用次数;免费api:每天剩余调用次数;收费api:剩余次数;无限制时为-1 |
remainSeconds | long | 1223456 | 剩余调用时间(s);免费api:-1;收费api:剩余调用时间;无限制时为-1 |
msg | string | 查询成功 | 参见下方错误码-系统级错误码 |
result | object | {...} | 接口返回结果 |
(2)业务返回参数
result参数信息
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
status_code | string | 0 | 参照四、错误码-业务错误码 |
status_message | string | "success" | 参照四、错误码-业务错误信息 |
check_result | int | 1 | 模型识别的结果。返回结果与含义对应关系如下表所示 |
description | string | "底签完整" | 返回的check_result的描述 |
request_id | string | "2c20715b-cfde-4048-96d3-fe831b5c80d1" | 用户在请求接口时传入的request_id,返回结果时再次回传给用户 |
check_result值及对应的含义: 返回值 | 含义 ------ | ------ 0 | 在输入图片中未检测到茅台外盒底部 1 | 在输入图片中检测到茅台外盒底部,且底签完整 -1 | 在输入图片中检测到茅台外盒底部,但底签不完整
2. 返回示例
{
"code": "0",
"charge": false,
"remain": 0,
"msg": "查询成功",
"result": {
"status_code": "0",
"status_message": "success",
"check_result": 1,
"description": "底签完整",
"request_id": "2c20715b-cfde-4048-96d3-fe831b5c80d1"
}
}
三、错误码
1.系统级错误码
2.业务错误码
业务错误码(status_code) | 信息(status_message) | 说明 |
---|---|---|
0 | "success" | 成功 |
40000 | "missing request id" | 缺少参数:request_id |
40001 | "missing base64" | 缺少参数:img_base64 |
40002 | "unsupport request id" | 不支持的request_id |
40003 | "broken base64" | img_base64解析错误 |
40004 | "image too large" | 图像过大,图像长、宽均应小于2048 |
40005 | "image too small" | 图像过小,图像长、宽均应大于512 |
50000 | "internal server error" | 系统内部错误 |