万店掌 开放平台 巡店执行记录列表接口

open.ai.public.aicheck.getRecordList (巡店执行记录列表接口)

门店摄像头抓拍的图片传给巡店平台,平台将图片传给算法进行检测给出检测结果,包含检测物体的坐标信息以及是否合格等,平台生成一条执行记录。用户通过该接口可以查看某个门店下产生的所有执行记录信息,可以根据一定的条件筛选满足条件的记录。

接口描述#

环境接口方法提交方式是否需要签名HTTP请求路由
正式环境open.ai.public.aicheck.getRecordListPOSTtruehttp://cloudapi.ovopark.com/cloud.api

公共请求参数#

参数类型是否必填最大长度描述示例值
_aidString20开放平台系统编号,固定为S107S107
_akeyString20万店掌开放平台分配给第三方的开发者key认证平台开发者后获取
_mtString100接口名称open.ai.public.aicheck.getRecordList
_smString100签名算法 md5,sha1md5
_requestModeString100请求方式post,getPOST
_versionString100版本号v1
_timestampString100时间戳yyyyMMddHHmmss格式
_sigString32签名token根据签名算法生成,详情见签名算法规则
_formatString10format类型目前默认仅支持json

业务请求参数#

参数类型是否必填最大长度描述示例值
json
JSON100请求示例值查看
    
enterpriseId
int×1001084企业ID
    
depIdList
int×100[29303,29304]门店ID集合
    
typeIdList
int×100[1,2]检测类型集合(2.店面管理检测 3.着装检测 4.车间检测 5.老鼠检测 7.动作检测 9.实时动作检测 11.货架检测 12.实时着装检测 13.实时店面管理检测)
    
statusList
int×100[]检测结果集合(1.正常 2.异常 3.误检 4.无目标
    
startTime
string×1002022-12-06 00:00:00搜索时间范围-开始时间(搜索时间范围不传默认查询7天内)
    
endTime
string×1002022-12-07 23:59:59搜索时间范围-结束时间(搜索时间范围不传默认查询7天内)
    
pageNumber
int×1001分页的当前页数,默认1
    
pageSize
int×10010分页的每页大小数,默认10
    
scenceName
int×100测试场景值名称
    
labelNames
int×0测试检出检测项名称

公共响应参数#

参数类型最大长度描述示例值
statJSON-网关状态(具体参数描述如下:)查看
stat.cidString100http请求的标识符
stat.codeString100网关返回码
stat.codenameString100网关返回码名称
stat.systimeStringLong接口调用的当前时间
resultString100接口返回提示信息
dataJSON-接口调用返回的业务信息(一般是json格式数据,具体数据格式会在业务返回参数中定义)查看

业务返回参数#

参数名称类型是否一定返回返回最大长度描述示例值
data
JSON×100返回查看
    
list
int×100list测试
        
id
int×100执行记录ID 88
        
depId
int×100门店ID 88
        
depName
int×100门店名称 测试
        
applicationName
int×100巡店应用名称 测试
        
serveType
int×100检测类型 (2.店面管理检测 3.着装检测 4.车间检测 5.老鼠检测 7.动作检测 9.实时动作检测 11.货架检测 12.实时着装检测 13.实时店面管理检测) 1
        
resultStatus
int×100检测结果(1.正常 2.异常 3.误检 4.无目标) 1
        
createTime
int×100产生时间 测试时间
        
sceneId
int×100场景ID 11
        
sceneName
int×100场景名称 测试
        
deviceId
int×100设备ID 12312
        
sceneConfigId
int×100预置位ID 125
        
imageUrl
int×100抓拍图片url 测试地址
        
baiduResult
int×100算法识别结果集 结果
        
imageTestUrl
int×100检测结果图片 测试图片
        
duration
int×100出现时长,单位:分钟 10
        
appearTime
int×100出现时间 10
        
pageNumber
int×100页面1
        
pageSize
int×100页面大小10
        
total
int×100总计55
        
all
int×100所有11

公共返回码#

返回码名称返回码返回码描述解决方案
SUCCESS0调用成功
KEY_NOTNULL1_akey和不能为空接口调用时传入_akey参数
KEY_UNLAWFUL2_akey不合法key是非法的,传入正确的key
KEY_HAS_EXPIRED3_akey已过期请续订服务或联系平台管理人员
SIGN_METHOD_NOTNULL4_sm参数不能为空接口调用时传入_sm参数
SIGN_TYPE_NOTEXIST5_sm类型不存在目前仅支持md5,sha1
SIGN_NOTNULL6_sig参数不能为空接口调用时传入_sig参数
SIGN_WRONG7无效的签名,请检查参数和签名格式_sig值根据签名算法生成
METHOD_NOTNULL8_mt参数不能为空接口调用时传入_mt参数
METHOD_NOTEXIST_CODE9_mt对应的方法名不存在或未注册进服务检查_mt方法名和_version版本号对应的方法是否传入错误
REQUESTMODE_NOTNULL10_requestMode参数不能为空接口调用时传入_requestMode参数
APPLICATIONID_NOTNULL11_aid参数不能为空接口调用时传入_aid参数
APPLICATIONID_NOTSAME12_aid与当前key不匹配_aid与_akey必须一一对应
VERSION_NOTNULL13_version版本号不能为空接口调用时传入_version参数
TIMESTAMP_NOTNULL14_timestamp时间戳不能为空接口调用时传入_timestamp参数
TIMESTAMP_FORMAT_ERROR15_timestamp时间戳格式化错误按照yyyyMMddHHmmss格式
TIMESTAMP_OVERTIME16_timestamp已失效_timestamp每次接口调用时重新生成
FORMAT_TYPE_NOTEXIST17_format类型不存在目前仅支持json(默认),xml
API_CALL_REPEAT-100接口重复调用接口平台调用异常
API_SYSTEM_CALL_ERROR-500api调用失败,系统发生异常接口平台调用异常
UNKNOWN_ERROR-999开放平台系统异常重新发起请求

业务返回码#

返回码名称返回码返回码描述
SUCCESS
0成功