查询短信模板申请单

查询短信模板申请单

1.请求参数:

请求URL:

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

公共参数

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

业务参数

参数名称 参数类型 是否必须 示例值 参数描述
sms_account String 1234 短信发送渠道,主要做资源隔离
template_content String 您购买的商品已重新发出,${name}快递运单号:${number},关注“XXX”公众号刷新订单获取最新物流信息哦~给您造成不便敬请谅解。 短信模板内容
sms_template_apply_id String 23423423 短信模板申请单id
size Int64 10 每页数量,默认10
page Int64 0 页码,默认0
status Int64 1 审核状态: 1:审核中 2:未通过 3:已开通 4:已关闭

2. 请求示例代码(Java)

       @Test
    public void  DDSmsTemplateApplyListRequest() 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.DDSmsTemplateApplyListRequestUrl, data);
        System.out.println(resp);
    }

3. 返回结果如下:

3.1 成功返回
{
    "code": 0,
    "message": "ok",
    "data": {
        "template_apply_list": [
            {
                "channel_type": "CN_NTC",
                "sms_account": "723fc3f6",
                "sms_template_apply_id": "147418",
                "status": 3,
                "status_remark": "",
                "template_content": "您购买的商品已重新发出,${name}快递运单号:${number},刷新订单获取最新物流信息哦~给您造成不便敬请谅解。",
                "template_name": "发货通知"
            } 
        ],
        "total": 1
    }
}

说明: code为0表示成功,非0为失败,message会包含失败原因。 业务层面的成功与否见内层的code, 0为成功.

4 返回字段说明

参数名称 参数类型 示例值 参数描述
total Int64 100 总数
template_apply_list List - 短信模板申请单列表
– sms_template_apply_id String 23423423 短信模板申请单id
–template_name String 618大促 短信模版名称
–template_content String 您购买的商品已重新发出,${name}快递运单号:${number},关注“XXX”公众号刷新订单获取最新物流信息哦~给您造成不便敬请谅解。 短信模版内容
template_id String 短信模板ID 模板状态为已开通时才会返回, 发送短信时需要用此短信模板ID
–channel_type String 模版类型 CN_NTC 国内通知短信 CN_MKT 国内营销短信(营销短信将自带退订功能) CN_OTP 国内验证码
–status Int64 1 审核状态: 1:审核中 2:未通过 3:已开通 4:已关闭
–status_remark String 签名重复 状态说明
文档更新时间: 2023-03-14 16:54   作者:admin