京东文本短信-产品接入手册
目录
操作指南
短信签名
在使用云鼎短信服务发送短信前，需要先创建应用，应用创建完成，您可以获得该应用的唯一标识码AppID (应用ID) 和用来校验短信发送请求合法性的密码 AccessKey 。
https://yd-sms-console.jdcloud.com/overview
登录短信云服务后, 首先您要先创建应用.业务组件-云鼎短信服务
创建应用后, 在短信签名TAB页, 点选 ‘创建签名’, 如下图
根据提示内容填写并上传资料证明, 点击提交后等待运营人员进行签名审核
提交审核后您可以在短信签名列表页查看审核状态, 审核通过的短信签名可用于短信发送
短信模板
在短信模板TAB页, 点选 ‘创建模板’, 如下图
根据提示内容填写模板内容, 点击提交后等待运营人员进行审核
国内文本短信分为三个类型:
- 验证码短信
- 通知短信
- 推广短信
验证码短信
验证码短信示例:
【京东云】欢迎您注册成为京东云用户，验证码为：${NUM_6}，5分钟内有效！
其中:
【京东云】为短信签名欢迎您注册成为京东云用户，验证码为：\${NUM_6}，5分钟内有效！为短信模板${NUM_6}为模板变量
验证码短信只支持一个变量
模板内容必须含验证码，注册码，校验码，动态码这 4 个词其中之一
必须包含使用平台，失效时间，用途其中之一
通知短信
通知短信示例:
【京东云】我是京东小哥${TXT_5}, 您的生鲜订单${TXT_10}即将送达, 请您准备收货!
其中:
【京东云】为短信签名我是京东小哥\${TXT_5}, 您的生鲜订单\${TXT_10}即将送达, 请您准备收货!为短信模板${TXT_5} ${TXT_10}为模板变量
不允许出现相同的变量名称
不支持变量与变量、短链接与变量直接组合的格式
推广短信
推广短信不支持加变量
不能发送贷款/借款/中奖/抽奖类短信，不支持金融理财/房产通知类短信（验证码除外）
提交审核后您可以在短信模板列表页查看审核状态, 审核通过的短信模板可用于短信发送
注:
验证码短信和通知短信需要通过API或SDK调用。
推广短信和通知类短信可以通过控制台“发送短信”页面进行在线发送, 在线发送不支持带变量的短信内容
API和SDK所需要的相关信息在概览页获取
模板变量规则
短信模板=固定文本+变量，或短信模板=固定文本。
变量为每次发送短信时的可变内容。
变量规则
每个模板中最多包含20个变量，最多连续2个变量在一起。（变量间包含文字则为不连续变量）
系统支持以下四种变量格式，请按照要求填写，并选择合适的变量格式及长度。
| 变量格式 | 类型 | 填写示例 | 说明 |
|---|---|---|---|
| ${TXT_数字} | 字符，即文本 | ${TXT_20} | “数字”指最大长度，取值范围：1~20，单位：字符数。 1个汉字、中文标点符号、其他非英文字符，或1个英文字母、数字、英文标点符号均按1个字符数计算。 请就实际业务进行取值，勿取值过大。 注：变量取值不能包含字符“{”和“}”，即大括号。否则，可能导致模板变量解析异常。 |
| ${NUM_数字} | 数字 | ${NUM_8} | “数字”指最大长度，取值范围：1~20，单位：字符数。1个数字按1个字符数计算。 发送短信时，只能填0到9的数字，不能带其他字符，如“-”。 请就实际业务进行取值，勿取值过大。 |
| ${DATE} | 日期 | ${DATE} | 发送短信时，格式为“YYYY/MM/DD”，例如2017/07/16、2017/7/16、2017/7/1。 |
| ${TIME} | 时间 | ${TIME} | 发送短信时，有两种格式。 • HH:MM，时 : 分，例如14:30。 • HH:MM:SS，时 : 分 : 秒，例如14:30:30。 |
模板类型特定规范
除公共规范外，短信的每种模板类型还有以下特定规范：
| 类别 | 变量规范 | 内容规范 |
|---|---|---|
| 验证码短信 | 仅支持一个变量，用于填写数字验证码。 | 验证码变量的“最大长度”只能8位及以下。 国内短信必须含有验证码，注册码，校验码，动态码这4个词其中之一。 |
| 通知短信 | 链接不支持使用变量发送，请填写在模板的固定文本中。 | 不支持带营销推广的内容。 |
| 推广短信 | 不支持变量，模板只能为纯固定文本。 | 推广短信除公共规范外，另禁止发送涉及以下信息的短信：培训、招商加盟类、团购会、装修（含建材，家私）、烟、酒、茶、捐款献血、迷信色彩、人工或软件刷单、做任务、虚拟货币、人民币收藏、钱币买卖、沙发翻新、工商代办、代开发票、买卖黑车、非法钓鱼、会展、网站、优惠券类推广、卡类、保险、税票、APP推广、办证、回收、医疗保健、POS机相关、信用卡、交友、猎头、直播及其他违反法律法规的内容。 只支持发送给有订购关系的会员用户，模板必须体现是发送给会员。 不支持发送给国际/港澳台地区。 |
注意：
模板规范可能随运营商规则变化实时调整，最终以模板审核结果为准。
购买云鼎短信套餐包
可在账户概览查看短信使用情况
发送短信
推广短信和不带变量的通知类短信可以通过控制台“发送短信”页面进行在线发送。
验证码短信和带变量的通知短信需要通过API或SDK调用。
接口调用地址
接口详细说明请参考 https://docs.jdcloud.com/cn/?act=3
统计分析
数据总览
在 数据总览 项中，您可以查看最近7天，最近 30 天或指定时间段的短信发送量和费用清单。
短信记录
在 短信记录 项中，输入手机号码，选择发送状态，单击【查询】，可以查看单个手机号在指定时间段的短信下发记录。
模板查询
在 模板查询 项中，输入模板 ID 后，单击【查询】，可查看指定时间内该模板的短信发送量和发送成功率。
回执分析
在 回执分析 项中，您可以查看最近7天，最近 30 天或指定时间段的短信回执详情和回执成功率分析。