如何测试短信接口调用代码

产品简介
1 产品概述
短信（Short Message Service）沉淀[Kewail](https://www.kewail.com/register.html?uid=1557798214802&cmo=4)多年短信服务技术和经验，帮助广大开发者快速灵活的接入高质量的文字或语音短信服务。

2 功能列表
Kewail短信服务当前支持的功能：

3 请求流程
一次短信（或语音）的业务请求流程如下所示：

单发短信

1. 进入控制台

1. 第一步，登录后台，创建Access Key,生成Access Key ID和Secret Access Key；用于调用接口和识别区分用户数据。

2. 第二步，申请新签名，待相关工作人员审核通过后，即可使用。

3. 第三步，申请新内容模板，待相关工作人员审核通过后，即可使用。

2 调用短信接口
协议 HTTP POST
编码格式 UTF8
URL https://live.kewail.com/sms/v1/sendsinglesms
接口说明 给用户发短信验证码、短信通知，营销短信（内容长度不超过450字）。
注：accesskey请填写您在Kewail上申请到的，random请填成随机数。 2) 请求参数：
参数名称 参数类型 是否必填 说明
accesskey String 是 用户控制台中对应的accesskey
random int 是 随机整数 3) 请求包体：
参数名称 参数类型 是否必填 说明
sig String 是 签名，用于校验用户的合法性；签名用SHA加密，加密的参数顺序为(secretkey=%s&random=%d&time=%d&mobile=%s)
time long 是 unix时间
type int 是 0:普通短信;1:营销短信（强调：要按需填值，不然会影响到业务的正常使用）
nationcode int 是 国家码(例如：86)
mobile int 是 手机号码
msg String 是 需要匹配审核通过的模板内容
extend String 否 通道扩展码，可选字段，默认没有开通(需要填空)。
ext String 否 服务端原样返回的参数，可填空 4) 返回值：
名称 类型 返回值
result int 0表示成功(计费依据)，非0表示失败错误码
errmsg string 错误的信息，如果是成功则为OK
fee int 短信计费的条数
sid string 标识本次发送id，标识一次短信下发记录
ext string 服务端原样返回的参数5) 样例demo:
请求的样例如下： https://live.kewail.com/sms/v1/sendsinglesms?accesskey=xxxxx&random=xxxxx
3 包体为json字符串及解析
包体为json字符串，参数如下：
{
“tel”: { //如需使用国际电话号码通用格式，如："+8613788888888" ，请使用sendisms接口见下注
“nationcode”: “86”, //国家码
“mobile”: “13788888888” //手机号码
},
“type”: 0, //0:通知短信;1:营销短信（强调：要按需填值，不然会影响到业务的正常使用）
“msg”: “尊敬的客户:您本次的验证码为:123456”, //utf8编码
“sig”: “30db206bfd3fea7ef0db929998642c8ea54cc7042a779c5a0d9897358f6e9505”, //app凭证，具体计算方式见下注
“time”: 1457336869, //unix时间戳，请求发起时间，如果和系统时间相差超过10分钟则会返回失败
“extend”: “”, //通道扩展码，可选字段，默认没有开通(需要填空)。
//在短信回复场景中，Kewailserver会原样返回，开发者可依此区分是哪种类型的回复
“ext”: “”, //用户的session内容，Kewailserver回包中会原样返回，可选字段，不需要就填空。
}
注： 1、“msg"字段需要匹配审核通过的模板内容
如果您的模板是"尊敬的客户:你的验证码是{1}”，则"msg"字段可赋值为：“尊敬的客户:你的验证码是xxxx”。（其中"xxxx"为下发的验证码） 如果您有多个短信签名，请将需要的短信签名放在短信内容前面 例如您有"【Kewail科技】"，"【Kewail】“两个签名，但是想以”【Kewail】“签名发送短信， 则"msg"字段可赋值为：”【Kewail】尊敬的客户:你的验证码是xxxx"。（其中"xxxx"为下发的验证码）
2、“extend"字段的配置请联系Kewail短信技术支持
3、sendisms接口，“tel"字段为国际电话号码通用格式，如：”+8613788888888”
4、"sig"字段根据公式sha256(secretkey=KaTeX parse error: Expected 'EOF', got '&' at position 10: accesskey&̲random=random&time=KaTeX parse error: Expected 'EOF', got '&' at position 5: time&̲mobile=mobile)生成。
4 SDK

指定模板单发短信

1. 进入控制台

1. 第一步，登录后台，创建Access Key,生成Access Key ID和Secret Access Key；用于调用接口和识别区分用户数据。
2. 第二步，申请新签名，待相关工作人员审核通过后，即可使用。
3. 第三步，申请新内容模板，待相关工作人员审核通过后，即可使用。
   2 调用短信接口
   协议 HTTP POST
   编码格式 UTF8
   URL https://live.kewail.com/sms/v2/sendsinglesms
   接口说明 给用户发短信验证码、短信通知，营销短信（内容长度不超过450字）。
   注：accesskey请填写您在Kewail上申请到的，random请填成随机数。 2) 请求参数：
   参数名称 参数类型 是否必填 说明
   accesskey String 是 用户控制台中对应的accesskey
   random int 是 随机整数 3) 请求包体：
   参数名称 参数类型 是否必填 说明
   sig String 是 签名，用于校验用户的合法性；签名用SHA加密，加密的参数顺序为(secretkey=%s&random=%d&time=%d&mobile=%s)
   signId String 是 短信签名ID (登录后台页面获取)
   templateId String 是 业务在控制台审核通过的模板ID
   time long 是 unix时间
   type int 是 0:普通短信;1:营销短信（强调：要按需填值，不然会影响到业务的正常使用）
   nationcode int 是 国家码(例如：86)
   mobile int 是 手机号码
   params List 是 短信的变量参数值 ，将短信模板中的变量{0},{1}替换为参数中的值，如果短信模板中没有变量，填null
   ext String 否 用户的session内容，Kewailserver回包中会原样返回，可选字段，不需要就填空。 4) 返回值：
   名称 类型 返回值
   result int 0表示成功(计费依据)，非0表示失败错误码
   errmsg string 错误的信息，如果是成功则为OK
   sid string 标识本次发送id，标识一次短信下发记录
   ext string 用户的session内容，Kewailserver回包中会原样返回
   surplus int 剩余短信投递量5) 样例demo:
   请求的样例如下： https://live.kewail.com/sms/v2/sendsinglesms?accesskey=xxxxx&random=xxxxx
   3 包体为json字符串及解析
   包体为json字符串，参数如下：
   {
   “tel”: { //如需使用国际电话号码通用格式，如："+8613788888888" ，请使用sendisms接口见下注
   “nationcode”: “86”, //国家码
   “mobile”: “13788888888” //手机号码
   },
   “signId”: “5aa7ef278475af0e19b05f5b”, //短信签名，如果使用默认签名，该字段可缺省
   “templateId”: “5a9599a56fcafe461546b953”, //业务在控制台审核通过的模板ID
   //假定这个模板为：您的注册的验证码是:{1}，有效时间{2}分钟。
   “params”: [
   “35558”,
   “30”
   ], //参数，分别对应上面假定模板的{1}，{2}
   “sig”: “30db206bfd3fea7ef0db929998642c8ea54cc7042a779c5a0d9897358f6e9505”, //app凭证，具体计算方式见下注
   “time”: 1457336869, //unix时间戳，请求发起时间，如果和系统时间相差超过10分钟则会返回失败
   “extend”: “”, //通道扩展码，可选字段，默认没有开通(需要填空)。
   //在短信回复场景中，Kewailserver会原样返回，开发者可依此区分是哪种类型的回复
   “ext”: “”, //用户的session内容，Kewailserver回包中会原样返回，可选字段，不需要就填空。
   “type”: 0, //0:普通短信;1:营销短信（强调：要按需填值，不然会影响到业务的正常使用）
   }
   注：
   1、“templateId"字段需填写审核通过的模板ID ，上面的请求参数组合后下发的内容为： “【Kewail科技】您注册的验证码：35558有效时间30分钟。” 如果您有多个短信签名，请将需要的短信签名填入"signId"字段 例如您有”【Kewail科技】"，"【Kewail】“两个签名，但是想以”【Kewail】"签名发送短信，则"signId"字段可赋值为：“Kewail”
   2、“extend"字段的配置请联系Kewail短信技术支持
   3、sendisms接口，“tel"字段为国际电话号码通用格式，如：”+8613788888888”
   4、"sig"字段根据公式sha256(secretkey=%s&random=%d&time=%d)生成SDK。