本文档将给出尽量详尽的示例教程。

示例说明

本教程以野狗实时通信云的 套餐到期通知短信为例，讲解如何通过通知类 API 实现通知短信的发送（Java 端）。

示例最终发送到用户端的效果如下：

具体步骤

1. 创建应用

首先在控制面板中创建应用。如下：

2. 账户充值

如余额不足，请进入 控制面板-财务-充值 进行充值。

3. 配置短信

（1）配置签名

该签名会出现在下发短信的开头，建议写上你的品牌或产品名称。此处我们以【野狗实时】为例。在控制面板-短信-配置配置如下，签名提交后，需管理员审核。

（2）创建模版

模板短信由固定内容与多个变量构成，以套餐到期通知为例，模版配置如下：

其中 %s即为需要接口替换的变量：本例中为用户名和套餐种类。提交该模版会自动生成模版 ID（ templateId）。

4.生成数字签名（signature ）

（1）罗列实际调用的 API 参数，除去其中的 signature 字段。

因本次示例为 通知类短信，除去 signature后，传送的参数如下：

templateId：100001
mobiles：["13800138000"]
params：["王小豆","个人版套版套餐"]
timestamp：1506065665377

（2）将参数以字母升序(A-Z)排列，以 key=value’ + ‘&’ + ‘key=value的方式连接所有参数,得到字符串 param_str。

param_str="mobiles=["13800138000"]&params=["王小豆","个人版套版套餐"]&templateId=100001&timestamp=1506065665377"

（3）以 param_str + ‘&’ + SMS_KEY 的方式得到字符串 sign_str

sign_str="mobiles=["13800138000"]&params=["王小豆","个人版套版套餐"]&templateId=100001&timestamp=1506065665377&kYVAi9tXAbPOURnkWiiWADRuNi6DJy7JmSg02myB"

其中 SMS_KEY 在控制面板获取：

（4）计算 sign_str的 SHA256 值, 得到 signature

本例中字符串计算后的值如下：

01bbc7fb885d1d383b1c82c77c30ee151b590193c6b4f7208c966d5df867e7c7

5. 发送本条通知短信

curl -X POST https://sms.wilddog.com/api/v1/yourtestapp/notify/send -d "signature =01bbc7fb885d1d383b1c82c77c30ee151b590193c6b4f7208c966d5df867e7c7&templateId=100001&timestamp =1506065665377&mobiles=["13800138000"]&params=["王小豆","个人版套版套餐"]"

此处规则详情请参考 完整指南。

获取示例源码

点此获取完整的 示例源码。