万店掌 开放平台 巡店任务列表

open.xundian.public.getLiveCheckLog (巡店任务列表 )

巡店任务列表

接口描述#

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

公共请求参数#

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

业务请求参数#

参数类型是否必填最大长度描述示例值
pageNumber
int×0页码1
pageSize
int×0页长10
startTime
int×0开始时间yyyy-MM-dd HH:mm:ss
endTime
int×0结束时间yyyy-MM-dd HH:mm:ss

公共响应参数#

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

业务返回参数#

参数名称类型是否一定返回返回最大长度描述示例值
ArrayObject
JSON×10返回信息查看
taskId
int×0巡店任务id4563
evaluationCount
int×0点检项个数27
passCount
int×0合格点检项数22
notPassCount
int×0不合格数 22
notWorkCount
int×0不适用数 22
score
int×0得分100
scoreStr
int×0无用字段 无用字段
liveSeconds
int×0巡店有效时长(单位秒) 60
totalDuration
int×0巡店总时长(单位秒) 180
createTime
string×0任务创建时间 test
deptId
int×0门店id888
deptName
string×0门店名称 测试
extraMark
int×0额外扣分 2
moneyType
int×0奖惩类型(0奖励 1惩罚) 1
money
int×0奖惩金额 65
moneyStr
int×0moneyType 和 money 两个字段的结合,比如:moneyTpe =0 mongey = 5,则moneyStr=+5,反之moneyStr=-5 5
realScore
int×0忽略此字段 忽略此字段
totalScore
int×0忽略此字段 忽略此字段
company
int×0忽略此字段 忽略此字段
historyId
int×0忽略此字段 忽略此字段
resultEvaluate
int×0忽略此字段 忽略此字段
evaluateContent
int×0忽略此字段 忽略此字段
isComplete
int×00:进行中,1:已完成(无需审核),2:已失效,3:待审核,4:已完成(审核通过),5:已完成(自动审核通过) 0,1
isInRange
int×0任务提交是否在有效范围内(现场巡店), null:没有开启范围限制,0:不在有效范围内,1:在范围内 0,1
userId
int×0巡店人id 123
userName
string×0巡店人显示名 张山
isApproval
int×0忽略此字段 忽略此字段
parentDbViewShopList
int×0忽略此字段 忽略此字段
summary
int×0忽略此字段 忽略此字段
endTime
string×0巡店任务提交时间 test
templateId
int×0巡店任务模板id 123
templateName
string×0巡店任务模板名称 测试
isTemplate
int×0是否使用模板,0或null:未使用,1:使用 0
evaluationIds
int×0此巡店任务使用的模板或者分类巡店组装的字符串 1
taskHistorySubmitId
int×0history表id 123
samePerson
int×0当前登录的用户和此巡店任务的审核人是否同一个人,1:是,0:否 0
reviewerId
int×0审核人id 12
checkType
int×00:现场巡店,1:远程巡店,11:远程巡店(计划巡店中远程巡店)10:现场巡店(计划巡店中现场巡店),12:门店自检 ,12:巡检计划,17:巡店任务-门店自检 0,1
groupId
int×0企业id 555
sourceType
int×0忽略此字段 忽略此字段
outDepId
int×0门店表的shopId字段 126
ev
int×0忽略此字段 忽略此字段
appendixContent
int×0忽略此字段 忽略此字段

公共返回码#

返回码名称返回码返回码描述解决方案
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成功