查询短信模板

查询短信模板

一、请求参数

请求URL:

POST https://kf.fw199.com/gateway/dd/sms/template/search

公共参数

参数名称	参数类型	是否必须	示例值	参数描述
appid	String	是		合作伙伴AppId
timestamp	String	是	1657525936	当前Unix时间戳，秒
seller_nick	String	是	oms38173182	抖店的账号，对应蜂巢授权返回doudianseller字段
sign	String	是

业务参数

参数名称	参数类型	是否必须	示例值	参数描述
sms_account	String	是	1234	短信发送渠道，主要做资源隔离
template_id	String	否	7238746	短信模板id
template_content	String	否	您购买的商品已重新发出，${name}快递运单号：${number}，关注“XXX”公众号刷新订单获取最新物流信息哦~给您造成不便敬请谅解。	短信模版内容
page	Int64	否	0	页码，默认0
size	Int64	否	10	每页大小，默认10
template_name	String	否	618大促	短信模版名称

二、请求示例代码

Java

@Test
    public void  DDSmsTemplateSearchRequest() 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("page", 0);
        data.put("size", 20);
        data.put("sign", Sign(data,Config.AppSecret));
        // 调用服务API
        String resp = doHttpRequest(Config.DDSmsTemplateSearchRequestUrl, data);
        System.out.println(resp);
    }

三、返回结果

三（一）、成功返回

{
    "code": 0,
    "message": "ok",
    "data": {
        "template_search_list": [
            {
                "channel_type": "CN_MKT",
                "sms_account": "723fc3f6",
                "template_content": "您购买的商品已重新发出，加'群荐的铺子'公众号，实时售后维护~给您造成不便敬请谅解。回T退订",
                "template_id": "ST_72e7001c",
                "template_name": "售后服务"
            },
            {
                "channel_type": "CN_NTC",
                "sms_account": "723fc3f6",
                "template_content": "您购买的商品已重新发出，${name}快递运单号：${number}，刷新订单获取最新物流信息哦~给您造成不便敬请谅解。",
                "template_id": "ST_72e7423f",
                "template_name": "发货通知"
            }
        ],
        "total": 2
    }
}

说明： code为0表示成功，非0为失败，message会包含失败原因。

四、返回字段说明

参数名称	参数类型	示例值	参数描述
template_content	String	您购买的商品已重新发出，${name}快递运单号：${number}，关注“XXX”公众号刷新订单获取最新物流信息哦~给您造成不便敬请谅解。	短信模版内容
template_id	String		短信模板id
channel_type	String		CN_NTC 国内通知短信 CN_MKT 国内营销短信（免审模版营销短信将自带退订功能，非免审模版需自行添加退订描述） CN_OTP 国内验证码
template_name	String	618大促	短信模版名称
total	Int64	100	总条数