# K8关键词设置 ### 一、阅读前提 1. 调用此接口先详细阅读[K8授权说明文档](https://www.kancloud.cn/ly6886/k8-push/3191599)，并完成授权认证与[推送开关设置](推送开关设置.md)，才能调用此接口。 2. 设备须在线，才能触发指令控制。 3. 关于一二级黑白名单作用说明：当一个订单进入我们的系统时，它首先会经过一级黑白名单系统的检查、识别服务。如果一级系统无法明确识别订单，订单将继续通过二级黑白名单系统的筛选，以提高准确性。 4. 关于白名单设置说明，设置一二级白名单的关键词个数必须一样。示例说明：白名单单个关键词占位示例`[""]`，两个关键词占位示例`["",""]`,依此类推。 ### 二、设置接口 #### 接口信息 |协议|方式|地址 |-|-|-| |https|POST|/printer/setkeywords #### 请求参数 |名称|类型|必填|描述 |-|-|-|-|-| |client_id|string|是|应用id |sign|string|是|签名 |timestamp|int|是|时间戳（秒） |id|string|是|请求唯一标识码 |access_token|string|是|调用凭证 |machine_code|string|是|终端号 |keys|string|是|`order_payment`=需支付关键词；`order_non_payment`=指定关闭支付关键词；`order_id`=重打关键词；`order_refund`=退款关键词；`all`=所有关键词； |type|string|是|`white_list`=白名单；`two_white_list`=二级白名单；`black_list`=黑名单；`two_black_list`=二级黑名单；`all`=所有黑白名单 |content|json数组|是|关键词数据，一个数组中最大能设置`5个关键词`，单个关键词长度不能超过`10个中文字符`或者`20个英文字符` #### content 字段示例 ##### 正确示例： 一级白名单 ```json ["小计","总金额","支付"] ``` 二级白名单 ```json ["","",""] ``` 当keys和type的值等于`all`时示例 ```json {"order_non_payment":{"white_table":["关键字1","关键字2","关键字3"],"black_table":["关键字1","关键字2","关键字3"],"white_table2":["关键字1","关键字2","关键字3"],"black_table2":["关键字1","关键字2","关键字3"]},"order_id":{"white_table":["关键字1","关键字2","关键字3"],"black_table":["关键字1","关键字2","关键字3"],"white_table2":["关键字1","关键字2","关键字3"],"black_table2":["关键字1","关键字2","关键字3"]},"order_payment":{"white_table":["关键字1","关键字2","关键字3"],"black_table":["关键字1","关键字2","关键字3"],"white_table2":["关键字1","关键字2","关键字3"],"black_table2":["关键字1","关键字2","关键字3"]},"order_refund":{"white_table":["关键字1","关键字2","关键字3"],"black_table":["关键字1","关键字2","关键字3"],"white_table2":["关键字1","关键字2","关键字3"],"black_table2":["关键字1","关键字2","关键字3"]}} ``` ##### 错误示例： 一级白名单 ```json ["小计","总金额"] ``` 二级白名单 ```json ["","",""] ``` #### 响应参数 |名称|类型|描述 |-|-|-|-| |error|int|成功0，其他为异常 |error_description|string|提示信息 |timestamp|int|时间戳（秒） |body|json|数据