获取自定义模板打印项列表
获取自定义模板打印项列表。 此接口返回的打印项由ISV提供。 商家用模板列表接口,获取商家自己定义的模板(包括模板中商有自定义的打印项)。
一、请求参数
请求URL:
POST https://kf.fw199.com/gateway/ks/express/printer/element/query
| 参数名称 | 参数类型 | 是否必须 | 示例值 | 参数描述 |
|---|---|---|---|---|
| appid | String | 是 | 合作伙伴AppId | |
| timestamp | String | 是 | 1657525936 | 当前Unix时间戳,秒 |
| seller_nick | String | 是 | 38173182 | 快手的店铺账号,对应蜂巢授权返回seller_nick字段 |
| sign | String | 是 |
业务参数
不需要其他参数
| 参数名称 | 参数类型 | 是否必须 | 示例值 | 参数描述 |
|---|
二、请求示例代码
Java
/** * 快手获取自定义模板打印项列表。 * @throws Exception */ @Test public void ExpressPrinterElementQuery() throws Exception {
String sellerNick = Config.KSSellerNick ; //业务参 Map<String, String> data = new HashMap(); data.put("appid", Config.AppId); data.put("seller_nick", sellerNick); Long timestamp = System.currentTimeMillis(); data.put("timestamp", timestamp.toString()); // 参数签名 data.put("sign", Utils.Sign(data, Config.AppSecret)); String result = doHttpRequest(Config.KS_OPEN_EXPRESS_PRINTER_ELEMENT_QUERY, data); System.out.println("result:"+result); }三、返回结果
返回结果如下
{ "code": 0, "message": "ok", "data": [ { "itemCode": "EBTIO-13936", "itemContent": "\u003clayout left=\"0\" top=\"0\" width=\"76\" height=\"50\" id=\"ITEM\" ref=\"undefined\"\u003e\u003ctext left=\"1\" top=\"1\" width=\"45\" height=\"5\" presentation=\"商品名称\" style=\"overflow: hidden;zIndex: 1;fontColor: #000000;alpha: 255;valign: top;fontFamily: SimHei;fontSize: 6;fontWeight: normal;rotation: 0;\"\u003e\u003c![CDATA[\u003c%=_data.item_name%\u003e]]\u003e\u003c/text\u003e\u003c/layout\u003e", "itemName": "商品名称", "itemRemark": "商品名称", "itemType": 2 } ]}四、返回字段说明
返回code为0表示成功, 非0为失败,失败时message会有失败原因。data对象中的字段说明如下:
| 字段 | 类型 | 说明 |
|---|---|---|
| itemCode | String | 打印项编码 |
| itemName | String | 打印项名称 |
| itemRemark | String | 打印项描述 |
| itemType | Integer | 打印项类型 (1-标准模板打印项;2-自定义模板打印项) |
| itemContent | String | 打印项内容 |