1 基本描述
SaaS合作方可以通过商米数字店铺开放平台获取到业务操作日志
2 接口规范
2.1 协议说明
对接的接口目前只开放HTTPS方式推送消息,所有的消息一律采用POST方式。
Content-Type | application/x-www-form-urlencoded |
---|---|
数据格式 | 返回为JSON格式 |
字符编码 | UTF-8字符编码 |
签名算法 | MD5 |
签名规则 | 参考2.2 签名规则 |
2.2 签名规则
参考《鉴权认证》文档。
2.3 公共参数
参数名 | 必填 | 类型 | 说明 |
---|---|---|---|
app_id | 是 | string | 唯一标识接入身份,联系商米数字店铺提供 |
random | 是 | string | 随机字符串,由数字和字母组成,长度范围为6-10位 |
timestamp | 是 | int | 当前的unix timestamp,精度到秒级,10位数字 |
sign | 是 | string | 签名信息,详见2.2 |
3 店铺设计规范
参考《商户店铺》文档。
4 操作日志接口
4.1 操作日志业务范围
操作功能 | 操作内容 | 操作行为 |
巡店 | 抓拍配置(商户级业务) | 新建 修改(包含开启/关闭) 删除 |
巡店 | 模板配置(商户级业务) | 新建 修改 (包含 开启/关闭 ) 删除 |
巡店 | 巡店计划配置(商户级业务) | 新建 删除 |
- 备注:使用商户级别业务需要先进行商户级别的商户店铺体系对接
4.2 接口列表
接口名称 | 接口描述 |
/log/operation/company/getList | 获取操作日志列表 |
4.3 接口详情
4.3.1 获取商户级操作日志列表
接口描述:通过本接口调用,用户可以获取指定商户或者店铺下,指定时间范围内的操作日志列表
请求链接: /log/operation/company/getList
接口版本:v2.0
接口参数:
参数名称 | 是否必须 | 类型 | 说明 | 示例 |
sunmi_company_no | 是 | string | 商米数字店铺平台商户唯一编号 | 560279010307 |
start_time | 是 | string | 查询开始时间, Unix时间戳,秒级别 | 1578969264 |
end_time | 是 | string | 查询结束时间, Unix时间戳,秒级别 | 1579055640 |
page_num | 否 (默认1) | int | 当前页 | 1 |
page_size | 否 (默认10) | int | 当前页条目数量 | 10 |
- 备注:查询时间范围为90天
请求示例:
"method": "POST",
"url": "https://store.uat.sunmi.com/openapi/operation/company/log/getList",
"headers": {
"Content-Type": "application/x-www-form-urlencoded"
},
formData: {
"sunmi_company_no": "560279010307",
"app_id": "LMWWQVTW4QGCC",
"timestamp": 1581383983,
"random": "5dsf6698",
"sign": "33C18A18282733A71F998BB5A5E4319D"
"start_time": "1581333970",
"end_time": "1581363970",
}
返回值:
{
"data": {
"total_count": 5,
"operate_list": [{
"operate_event": "patrol.plan.create",
"operate_event_detail": "patrol.plan.create",
"operate_source": "web",
"operate_time": 1606707030,
"operate_payload": {
"params": {
"period_type": 2,
"plan_end_time": 1607011199,
"plan_name": "操作日志巡店计划测试",
"plan_start_time": 1606752000,
"plan_task_type": 6,
"week_day_list": []
},
"result": "success"
}
}, {
"operate_event": "patrol.template.update",
"operate_event_detail": "patrol.template.second_group.create",
"operate_source": "web",
"operate_time": 1606706053,
"operate_payload": {
"params": {
"check_item_list": [{
"full_score": 10,
"name": "操作日志点检项测试"
}],
"first_group_id": 115,
"second_group_name": "操作日志二级类测试",
"template_id": 10
},
"result": "success"
}
}, {
"operate_event": "patrol.template.update",
"operate_event_detail": "patrol.template.second_group.delete",
"operate_source": "web",
"operate_time": 1606706031,
"operate_payload": {
"params": {
"second_group_id": 120
},
"result": "success"
}
}, {
"operate_event": "patrol.template.update",
"operate_event_detail": "patrol.template.first_group.create",
"operate_source": "web",
"operate_time": 1606706024,
"operate_payload": {
"params": {
"first_group_name": "操作日志大类测试",
"template_id": 10
},
"result": "success"
}
}, {
"operate_event": "patrol.template.update",
"operate_event_detail": "patrol.template.second_group.create",
"operate_source": "web",
"operate_time": 1606706009,
"operate_payload": {
"params": {
"check_item_list": [{
"full_score": 10,
"name": "测试1"
}],
"first_group_id": 32,
"second_group_name": "操作日志测试",
"template_id": 10
},
"result": "success"
}
}]
},
"code": 0,
"msg": "succeed"
}
- 备注,相关枚举值如有需要详见具体业务
返回参数说明:
参数 | 说明 |
operate_list | 操作列表 |
operate_event | 操作事件 |
operate_event_detail | 操作详情 |
operate_source | 操作来源 |
operate_time | 操作时间 |
operate_payload | 操作内容 |
result | 操作结果 |
operate_event:
取值 | 说明 |
patrol.cronjob.create | 巡店业务 创建定时任务 |
patrol.cronjob.update | 巡店业务 更新定时任务(包括开启关闭) |
patrol.cronjob.delete | 巡店业务 删除定时任务 |
patrol.plan.create | 巡店业务 创建巡店计划 |
patrol.plan.delete | 巡店业务 删除巡店计划 |
patrol.template.create | 巡店业务 创建考评模板 |
patrol.template.update | 巡店业务 更新考评模板 (包括开启关闭) |
patrol.template.delete | 巡店业务 删除考评模板 |
operate_event_detail:
取值 | 说明 |
patrol.cronjob.create | 创建定时任务 |
patrol.cronjob.update | 更新定时任务(包括开启关闭) |
patrol.cronjob.delete | 删除定时任务 |
patrol.plan.create | 创建巡店计划 |
patrol.plan.delete | 删除巡店计划 |
patrol.template.create | 创建考评模板 |
patrol.template.update | 更新考评模板 (包括开启关闭) |
patrol.template.first_group.create | 创建模板一级检查大类 |
patrol.template.first_group.update | 更新模板一级检查大类 |
patrol.template.first_group.delete | 删除模板一级检查大类 |
patrol.template.second_group.create | 创建模板二级检查类(包含点检项) |
patrol.template.second_group.update | 更新模板二级检查类(包含点检项) |
patrol.template.second_group.delete | 删除模板二级检查类(包含点检项) |
patrol.template.delete | 删除考评模板 |
operate_source:
取值 | 说明 |
app | 商米助手 |
web | sunmi store页面 |
mgt | 商米后端管理平台 |
openapi | openapi接口调用 |
错误码:
错误码 | 说明 |
5041 | 商户组织参数错误 |
5000 | 数据库错误 |