如何快速接入短信接口测试?

短信(Short Message Service)沉淀Kewail多年短信服务技术和经验,帮助广大开发者快速灵活的接入高质量的文字或语音短信服务。

Kewail短信服务接入步骤:

1进入控制台

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

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

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

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。

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 212,332评论 6 493
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 90,508评论 3 385
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 157,812评论 0 348
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 56,607评论 1 284
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 65,728评论 6 386
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 49,919评论 1 290
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,071评论 3 410
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 37,802评论 0 268
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,256评论 1 303
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,576评论 2 327
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,712评论 1 341
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 34,389评论 4 332
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 40,032评论 3 316
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,798评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,026评论 1 266
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 46,473评论 2 360
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 43,606评论 2 350

推荐阅读更多精彩内容