订单插旗备注
为商家提供订单备注接口
一、请求参数
请求URL:
公共参数
| 参数名称 | 参数类型 | 是否必须 | 示例值 | 参数描述 |
|---|---|---|---|---|
| appid | String | 是 | 合作伙伴AppId | |
| timestamp | String | 是 | 1657525936 | 当前Unix时间戳,秒 |
| seller_nick | String | 是 | oms38173182 | 抖店的账号,对应蜂巢授权返回doudianseller字段 |
| sign | String | 是 |
业务参数
| 参数名 | 类型 | 是否必须 | 示例值 | 说明 |
|---|---|---|---|---|
| order_id | String | 是 | 6496679971677798670 | 父订单id |
| remark | String | 是 | 这是具体的备注内容 | 备注内容,最大不得超过60个字符 |
| is_add_star | String | 否 | true | 是否加旗标,不填则默认为否 true:需要加旗标 false:不加旗标 |
| star | String | 否 | 2 | 标星等级,范围0~5 0为灰色旗标,5为红色旗标,数字越大颜色越深 0灰 1紫 2青 3绿 4橙 5红 |
| sysid | 可选 | 是 | 应用标识,不清楚请咨询客服 |
二、请求示例代码
Java
@Test public void addOrderRmark() throws Exception { Map<String, Object> data = new HashMap<String, Object>(); data.put("appid", Config.AppId); Long timestamp = System.currentTimeMillis() / 1000; data.put("timestamp", timestamp.toString()); data.put("seller_nick", Config.DDSellerNick); data.put("order_id","4987737158544862534"); data.put("remark","这是通过蜂巢写入"); data.put("is_add_star","true"); data.put("star","4"); data.put("sign", Sign(data,Config.AppSecret)); // 调用服务API String resp = doHttpRequest(Config.DDOrderAddOrderRemarkUrl, data); System.out.println(resp); }三、返回结果
三(一)、成功返回
{"code":0,"message":"ok","data":null}三(二)、失败返回
{"code":1,"message":"非法的参数,订单号传入错误,建议检查是否为店铺单号"}说明: code为0表示成功,非0为失败,message会包含失败原因。