ดึงรายละเอียดเทมเพลต

ที่อยู่สำหรับเรียกใช้

GET https://otp.api.engagelab.cc/v1/template-configs/{templateId}

การยืนยันตัวตนในการเรียกใช้

โปรดดู การยืนยันตัวตนในการเรียกใช้ เพื่อเรียนรู้วิธีการยืนยันตัวตน API

คำขอ

พารามิเตอร์ของคำขอ

{templateId} ใน URL หมายถึง id ของเทมเพลตที่ต้องการดึง ซึ่ง id ของเทมเพลตนี้กำหนดโดยผู้เรียกใช้เองตอนเรียกอินเทอร์เฟซสร้างเทมเพลต

ตัวอย่างคำขอ

Header ของคำขอ

GET /v1/template-configs/{templateId} HTTP/1.1 Authorization: Basic amlndWFuZ2RldjpkZXZfc2VjcmV0
              
              GET /v1/template-configs/{templateId}  HTTP/1.1
Authorization: Basic amlndWFuZ2RldjpkZXZfc2VjcmV0

            
โค้ดนี้โชว์เป็นหน้าต่างลอย

เนื้อหาคำขอ

ไม่มี

การตอบกลับ

พารามิเตอร์การตอบกลับ

ส่งกลับเป็นออบเจ็กต์ JSON ที่มีข้อมูลการตั้งค่าโดยละเอียดของเทมเพลต

ตัวอย่างการตอบกลับ

การตอบกลับเมื่อสำเร็จ

{ "template_id": "test-template-1", // 自定义的模版id,应用内唯一 "description": "测试模版1", // 该模版的描述说明 "send_channel_strategy": "whatsapp|sms", // 模版的下发策略,支持whatsapp/sms/voice/email四类,组合策略则使用|字符表示失败补发 "brand_name": "品牌名称", // 品牌名称,用在一些国家地区模版内容中的签名(如短信通道中一些国家地区要求要注册签名) "verify_code_config": { // 验证码的配置,用于配置自动生成的验证码,模版包含验证码类型时返回 "verify_code_type": 1, // 验证码类型,取值范围[1,7] "verify_code_len": 6, // 验证码长度,取值范围[4,10] "verify_code_ttl": 1 // 验证码有效期,取值范围[1,10],注意当策略包含whatsapp时取值只能是1,5,10 }, "whatsapp_config": { // whatsapp策略的配置,当下发策略包含whatsapp时返回 "template_type": 1 // whatsapp模版类型,目前仅支持默认模版,即固定取值为1 }, "sms_config": { // sms策略的配置,当下发策略包含sms时返回 "template_type": 2, // sms模版类型,取值:1-默认模版/2-自定义模版 "template_parts": 1, // sms模版预估的计费条数,模版过长则会具体的价格=计费条数*计费单价 "template_custom_config": { // sms自定义模版配置,sms模版类型为自定义模版时有效 "custom_sub_type": "authentication", // 自定义模版类型,取值:authentication-验证码/marketing-营销/utility-通知 "custom_content": "xxx" // 自定义模版内容,注意若子类型为authentication验证码类型时必须包含{{code}}变量 } }, "voice_config": { // voice策略的配置,当下发策略包含voice时返回 "template_type": 1 // voice模版类型,目前仅支持默认模版,即固定取值为1 }, "email_config": { // email策略的配置,当下发策略包含email时返回 "template_name": "email模板名称", // email模版名称 "template_custom_configs": [{ // email自定义模版配置,email模版类型为自定义模版时有效,注意这里是对象数组,主要是通过language进行区分配置多个 "language": "default", // 语言,default为默认,消息下发时可以根据language参数来匹配不同的模版内容 "pre_from_name": "test", // 预设的发送人名称 "pre_from_mail": "test@test.com", // 预设的发送人邮箱 "pre_subject": "test", // 预设的邮件主题 "template_content": "预设邮件模版内容,必填,自定义变量如{{self}},验证码是{{code}}", // 邮件内容,支持html,变量需要使用两个大括号{{}}括起来 "pre_param_map": { // 邮件内容中变量的默认值,即下发时若不指定变量值,则采用下述的默认值来替换变量,采用key-value对声明 "self": "这里是self变量预设值" } }] }, "pwa_config": { // pwa相关的配置,具有pwa配置时才会返回 "pwa_platform": "xx", // 使用的pwa平台 "pwa_code": "xx" // 使用的pwa平台中的code }, "created_time": 1234567890, // 该模版的创建时间,时间戳格式,精确到秒 "status": 1, // 模版状态,取值:1-待审核/2-审核通过/3-审核拒绝 "audit_remark": "xx" // 审核备注,一般当审核拒绝时可以查看该字段看审核拒绝说明 }
              
              {
    "template_id": "test-template-1",       // 自定义的模版id,应用内唯一
    "description": "测试模版1",                 // 该模版的描述说明
    "send_channel_strategy": "whatsapp|sms",    // 模版的下发策略,支持whatsapp/sms/voice/email四类,组合策略则使用|字符表示失败补发
    "brand_name": "品牌名称",                   // 品牌名称,用在一些国家地区模版内容中的签名(如短信通道中一些国家地区要求要注册签名)
    "verify_code_config": {                     // 验证码的配置,用于配置自动生成的验证码,模版包含验证码类型时返回
        "verify_code_type": 1,                  // 验证码类型,取值范围[1,7]
        "verify_code_len": 6,                   // 验证码长度,取值范围[4,10]
        "verify_code_ttl": 1                    // 验证码有效期,取值范围[1,10],注意当策略包含whatsapp时取值只能是1,5,10
    },
    "whatsapp_config": {                        // whatsapp策略的配置,当下发策略包含whatsapp时返回
        "template_type": 1                      // whatsapp模版类型,目前仅支持默认模版,即固定取值为1
    },
    "sms_config": {                             // sms策略的配置,当下发策略包含sms时返回
        "template_type": 2,                     // sms模版类型,取值:1-默认模版/2-自定义模版
        "template_parts": 1,                    // sms模版预估的计费条数,模版过长则会具体的价格=计费条数*计费单价
        "template_custom_config": {             // sms自定义模版配置,sms模版类型为自定义模版时有效
            "custom_sub_type": "authentication",    // 自定义模版类型,取值:authentication-验证码/marketing-营销/utility-通知
            "custom_content": "xxx"                // 自定义模版内容,注意若子类型为authentication验证码类型时必须包含{{code}}变量
        }
    },
    "voice_config": {                           // voice策略的配置,当下发策略包含voice时返回
        "template_type": 1                      // voice模版类型,目前仅支持默认模版,即固定取值为1
    },
    "email_config": {                           // email策略的配置,当下发策略包含email时返回
        "template_name": "email模板名称",                     // email模版名称
        "template_custom_configs": [{           // email自定义模版配置,email模版类型为自定义模版时有效,注意这里是对象数组,主要是通过language进行区分配置多个
            "language": "default",              // 语言,default为默认,消息下发时可以根据language参数来匹配不同的模版内容
            "pre_from_name": "test",            // 预设的发送人名称
            "pre_from_mail": "test@test.com",   // 预设的发送人邮箱
            "pre_subject": "test",              // 预设的邮件主题
            "template_content": "预设邮件模版内容,必填,自定义变量如{{self}},验证码是{{code}}",    // 邮件内容,支持html,变量需要使用两个大括号{{}}括起来
            "pre_param_map": {                  // 邮件内容中变量的默认值,即下发时若不指定变量值,则采用下述的默认值来替换变量,采用key-value对声明
                "self": "这里是self变量预设值"
            }
        }]
    },
    "pwa_config": {                             // pwa相关的配置,具有pwa配置时才会返回
        "pwa_platform": "xx",                   // 使用的pwa平台
        "pwa_code": "xx"                        // 使用的pwa平台中的code
    },
    "created_time": 1234567890,                 // 该模版的创建时间,时间戳格式,精确到秒
    "status": 1,                                 // 模版状态,取值:1-待审核/2-审核通过/3-审核拒绝
    "audit_remark": "xx"                        // 审核备注,一般当审核拒绝时可以查看该字段看审核拒绝说明
}

            
โค้ดนี้โชว์เป็นหน้าต่างลอย

การตอบกลับเมื่อล้มเหลว

{ "code": 4001, "message": "config not exist" }
              
              {
    "code": 4001,
    "message": "config not exist"
}

            
โค้ดนี้โชว์เป็นหน้าต่างลอย

รหัสข้อผิดพลาด

รหัสข้อผิดพลาด http code คำอธิบาย
1000 500 ข้อผิดพลาดภายใน
2001 401 การยืนยันตัวตนล้มเหลว ไม่ได้แนบ token ที่ถูกต้อง
2002 401 การยืนยันตัวตนล้มเหลว token หมดอายุหรือถูกปิดใช้งานแล้ว
2004 403 ไม่มีสิทธิ์เรียกใช้ API นี้
4001 400 ไม่พบเทมเพลต
Icon Solid Transparent White Qiyu
ติดต่อฝ่ายขาย