云服务器内容精选

  • 请求参数 表1 请求Body参数 参数 是否必选 参数类型 描述 tpl_id 否 String 智能信息基础版模板ID。 tpl_size 否 String 智能信息基础版模板的大小。 说明: 单位:字节,audit_status非0时tpl_size为0。 valid_time 否 String 模板截止有效日期,格式:yyyy-MM-ddTHH:mm:ssZ,0:表示永久有效。样例:2020-01-31T23:59:59Z。 audit_state 否 String 智能信息基础版模板审核状态。 0:正常可用 1:审核中 2:审核不通过 3:模板已禁用 4:模板不存在 5:模板已过期 audit_desc 否 String 智能信息基础版模板状态的描述,若状态是审核不通过或被禁用,描述表示的是不通过或禁用的原因。 说明: 长度不超过 1024 字。 status_detail 否 Array of StatusDetail objects 运营商的模板状态详情。 preview_url 否 String 智能信息基础版模板预览地址。 tpl_name 否 String 智能信息基础版模板名称。 title 否 String 智能信息基础版模板主题。 tpl_sign 否 String 智能信息基础版模板签名。 create_time 否 String 智能信息基础版模板创建时间,格式:yyyy-MM-ddTHH:mm:ssZ。 var_info 否 Array of VarInfo objects 智能信息基础版模板动参信息,静态模板没有动参,该字段填空。 restags 否 String 资源分配标签,取值如下: 三网一般 三网抗诉 单网一般 单网抗诉 表2 StatusDetail 参数 是否必选 参数类型 描述 carrier 否 String 运营商类型。 cmcc:中国移动 cucc:中国联通 ctcc:中国电信 oversea:港澳台及国外 unknown:未知 status 否 String 模板状态。 0:正常可用 1:审核中 2:审核不通过 3:模板已禁用 4:模板不存在 5:模板已过期 desc 否 String 对模板状态的描述。 说明: 若状态是审核不通过或被禁用,描述表示的是不通过或禁用的原因。 表3 VarInfo 参数 是否必选 参数类型 描述 name 否 String 动参变量占位符名称。 说明: 格式:#p_N#(N表示第几个参数,与模板文件占位名称保持一致),如:#p_1#。 type 否 String 动参变量类型。类型为文字:txt。
  • 请求示例 智能信息基础版模板状态回执。模板ID为"800000001",模板截止有效日期为"20200131",模板审核状态正常可用;运营商审核正常可用为"cucc",模板已过期为"cmcc",审核不通过为"ctcc"。 https:// koomessage.myhuaweicloud.cn/v1/aim-basic/template-status { "tpl_id" : "800000001", "tpl_size" : 102311, "valid_time" : 20200131, "audit_state" : 0, "restags" : "三网一般", "audit_desc" : "正常可用", "status_detail" : [ { "carrier" : "cmcc", "status" : 5, "desc" : "正常可用" }, { "carrier" : "cucc", "status" : 0, "desc" : "正常可用" }, { "carrier" : "ctcc", "status" : 2, "desc" : "审核不通过,携带敏感词汇" } ], "preview_url" : "http://example.com/000001", "tpl_name" : "模板名称", "title" : "模板主题", "tpl_sign" : "华为云消息", "create_time" : "2022-01-01T00:00:00Z", "var_info" : [ { "name" : "#p_1#", "type" : "txt" }, { "name" : "#p_2#", "type" : "txt" } ] }
  • 请求示例 新建模板 https://koomessage.myhuaweicloud.cn/v1/aim-basic/templates{ "tpl_name" : "测试-路由器推广", "title" : "测试主题", "reslist" : [ { "type" : "txt", "name" : "广告文本", "source" : "txt", "content" : "【华为云】测试-尊敬的#p_1#你好,最新路由器出来啦" }, { "type" : "jpg", "name" : "one.jpg", "source" : "file", "content" : "iVBORw0KGgoAAAANSUhEUgAAAKoAAABOCAYAAACwo40WAAAACXBIWXMAAA7EAAAOxAGVKw4bAAAAEXRFWHRTb2Z0d2Fy..." }, { "type" : "jpg", "name" : "two.jpg", "source" : "file", "content" : "iVBORw0KGgoAAAANSUhEUgAAAKoAAABOCAYAAACwo40WAAAACXBIWXMAAA7EAAAOxAGVKw4bAAAAEXRFWHRTb2Z0d2FyZQBTbmlwYXN0ZV0Xzt0AACAASURB..." }, { "type" : "png", "name" : "three.png", "source" : "url", "content" : "https://dss0.bdstatic.com/5aV1bjqh_Q23odCf/static/superman/img/topnav/tupian@2x-482fc011fc.png" } ], "remarks" : "请将此模板类型设置为绑定通道类型是三网合一通道", "expiration_time" : 1}
  • 响应参数 状态码: 200 表4 响应Body参数 参数 参数类型 描述 tplid String 智能信息基础版模板ID。 状态码: 400 表5 响应Body参数 参数 参数类型 描述 error_code String 结果状态码。 error_msg String 结果详情。 状态码: 500 表6 响应Body参数 参数 参数类型 描述 error_code String 结果状态码。 error_msg String 结果详情。
  • 请求参数 表1 请求Header参数 参数 是否必选 参数类型 描述 Content-Type 是 String 请求体参数类型,该字段必须设置为:application/json。 X-Auth-Token 是 String 用户Token。通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 表2 请求Body参数 参数 是否必选 参数类型 描述 expiration_time 是 String 智能信息基础版模板有效期。单位:天,必须取整,最长9999天。 tpl_name 是 String 智能信息基础版模板名称。模板的别名,用来帮助记忆。最大不超过100个字,若使用中文需经过UTF-8编码。 title 是 String 智能信息基础版模板主题,最大不超过20个字,若使用中文需经过UTF-8 编码,主题不能包含“【】”,否则审核会不通过。 reslist 是 Array of ResourceInfo objects 模板资源列表,由按顺序排列的资源组成,资源类型支持文本、图片、音频、视频。 说明: 资源在JSON数组中的顺序将决定其在手机上的显示顺序,数组大小不能超过10。 remarks 否 String 智能信息基础版模板备注信息,用于填写对模板审核的期望或要求,最大不超过200个字。例如:希望这个模板绑定的通道类型是三网合一通道,默认优先绑定三网合一通道。 callbackurl 否 String 客户系统回调URL,可用于通知对端模板审核状态信息。 说明: 接口规格需参照定义智能信息基础版模板状态回执完成实现。 表3 ResourceInfo 参数 是否必选 参数类型 描述 index 否 String 智能信息基础版序号。 从1开始,例如: 1-1,表示第1帧第1个元素;1-2:表示第1帧第2个元素;2-1:表示第2帧第1个元素。 说明: 每帧支持最多2个元素,2个元素中必须包含有文本 如果未填该字段,则每个元素独占一帧并按数组顺序排序 最多支持8帧 最多2帧同时包含2个元素 index必须全部指定,或者全为空,不能重复 type 是 String 智能信息基础版资源类型。 类型为文字填:txt 类型为图片填:jpg/jpeg/png/gif 类型为音频填:mp3/wav 类型为视频填:mp4/3gp name 是 String 智能信息基础版资源名称。 source 是 String 智能信息基础版资源来源。 txt:表示资源内容是纯文字 file:表示资源内容来源于文件流 url:表示资源内容来源于URL外链 说明: 资源来自于文字/文件流/URL外链。 content 是 String 智能信息基础版资源信息内容。 当source=txt时,填写经过UTF-8编码的文字 当source=file时,填写经过Base64编码的文件流,不须带文件格式前缀,样例:"iVBORw0KGgoAAAANSUhEUgA...",样例过长,未显示全部 当source=url时,填写资源URL地址,URL长度不能超过1024个字节 说明: 文字中可以使用#p_n#参数变量占位,n为1~100内的数字,相同类型的资源同一参数占位符可复用。如:#p_1#已表示是文本参数占位符时,其它位置的文本类型资源可以包含该文本参数占位符。不能包含除模板签名外的“【】” 第一个文本帧,内容必须以:【签名】开始,“签名” 标识客户信息