1 產品概述

短信(Short Message Service)沉淀Kewail多年短信服務技術和經驗,幫助廣大開發者快速靈活的接入高質量的文字或語音短信服務。

2 功能列表

Kewail短信服務當前支持的功能:

3 請求流程

一次短信(或語音)的業務請求流程如下所示:

 


1. 進入控制臺

1) 第一步,登錄后臺,創建Access Key,生成Access Key ID和Secret Access Key;用于調用接口和識別區分用戶數據。

2) 第二步,申請新簽名,待相關工作人員審核通過后,即可使用。

2) 第三步,申請新內容模板,待相關工作人員審核通過后,即可使用。

2 調用短信接口
協議 HTTP POST
編碼格式 UTF8
URL https://live.kewail.com/sms/v1/sendsinglesms
接口說明 給用戶發短信驗證碼、短信通知,營銷短信(內容長度不超過450字)。
注:accesskey請填寫您在Kewail上申請到的,random請填成隨機數。
參數名稱參數類型是否必填說明
accesskey String 用戶控制臺中對應的accesskey
random int 隨機整數
參數名稱參數類型是否必填說明
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 服務端原樣返回的參數,可填空

名稱 類型 返回值
result int 0表示成功(計費依據),非0表示失敗錯誤碼
errmsg string 錯誤的信息,如果是成功則為OK
fee int 短信計費的條數
sid string 標識本次發送id,標識一次短信下發記錄
ext string 服務端原樣返回的參數

請求的樣例如下: 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=$accesskey&random=$random&time=$time&mobile=$mobile)生成。

4 SDK

我們為開發者封裝了多個平臺的 API 供開發者直接使用,以節省開發時間,點擊這里查看

 


1. 進入控制臺

1) 第一步,登錄后臺,創建Access Key,生成Access Key ID和Secret Access Key;用于調用接口和識別區分用戶數據。

2) 第二步,申請新簽名,待相關工作人員審核通過后,即可使用。

2) 第三步,申請新內容模板,待相關工作人員審核通過后,即可使用。

2 調用短信接口
協議 HTTP POST
編碼格式 UTF8
URL https://live.kewail.com/sms/v2/sendsinglesms
接口說明 給用戶發短信驗證碼、短信通知,營銷短信(內容長度不超過450字)。
注:accesskey請填寫您在Kewail上申請到的,random請填成隨機數。
參數名稱參數類型是否必填說明
accesskey String 用戶控制臺中對應的accesskey
random int 隨機整數
參數名稱參數類型是否必填說明
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回包中會原樣返回,可選字段,不需要就填空。

名稱 類型 返回值
result int 0表示成功(計費依據),非0表示失敗錯誤碼
errmsg string 錯誤的信息,如果是成功則為OK
sid string 標識本次發送id,標識一次短信下發記錄
ext string 用戶的session內容,Kewailserver回包中會原樣返回
surplus int 剩余短信投遞量

請求的樣例如下: 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)生成

4 SDK

我們為開發者封裝了多個平臺的 API 供開發者直接使用,以節省開發時間,點擊這里查看。

 


1. 進入控制臺

1) 第一步,登錄后臺,創建Access Key,生成Access Key ID和Secret Access Key;用于調用接口和識別區分用戶數據。

2 調用短信接口
協議 HTTP GET
編碼格式 UTF8
URL http://live.kewail.com/sms/v2/dataQuery?accesskey=xxxx
接口說明 給用戶查詢用戶余額,及短信和郵件的剩余量。
注:accesskey請填寫您在Kewail上申請到的。
參數名稱參數類型是否必填說明
accesskey String 用戶控制臺中對應的accesskey

名稱 類型 返回值
username String 用戶名
balance int 余額
mailBizNum int 商業郵件余量
mailTranNum int 事務郵件余量
smsBizNum int 平臺短信余量
smsTranNum int 接口短信余量

請求的樣例如下: http://live.kewail.com/sms/v2/dataQuery?accesskey=xxxx
 


1 協議說明

協議 HTTP POST
編碼格式 UTF8
URL https://live.kewail.com/sms/v1/sendvoice
接口說明 給用戶發語音驗證碼(支持英文字母、數字及組合)。
注:accesskey請填寫您在Kewail上申請到的,random請填成隨機數。

請求的樣例如下: https://live.kewail.com/sms/v1/sendvoice?accesskey=xxxxx&random=xxxxx
2 請求包體

包體為json字符串,參數如下:

		{
    "tel": {
        "nationcode": "86", //國家碼
        "mobile": "13788888888" //手機號碼
    }, 
    "msg": "1234", //驗證碼,支持英文字母、數字及組合;實際發送給用戶時,語音驗證碼內容前會添加"您的驗證碼是"語音提示。
    "playtimes": 2, //播放次數,可選,最多3次,默認2次
    "sig": "30db206bfd3fea7ef0db929998642c8ea54cc7042a779c5a0d9897358f6e9505", //app憑證,具體計算方式見下注
    "time": 1457336869, //unix時間戳,請求發起時間,如果和系統時間相差超過10分鐘則會返回失敗
    "ext": "", //用戶的session內容,Kewailserver回包中會原樣返回,可選字段,不需要就填空。
}

					
									

注:
1、"sig"字段根據公式sha256(secretkey=$accesskey&random=$random&time=$time&mobile=$mobile)生成
偽代碼如下:

 
string strMobile = "13788888888"; //tel的mobile字段的內容
string strsecretkey = "dffdfd6029698a5fdf4"; //accesskey對應的accesskey,需要業務方高度保密
string strRand = "7226249334"; //url中的random字段的值
string strTime = "1457336869"; //unix時間戳
string sig = sha256(secretkey=$strsecretkey&random=$strRand&time=$strTime&mobile=$strMobile);

					
3 應答包體
 
{
    "result": 0, //0表示成功,非0表示失敗
    "errmsg": "OK", //result非0時的具體錯誤信息
    "ext": "", //用戶的session內容,Kewailserver回包中會原樣返回
    "callid": "xxxx" //標識本次發送id,標識一次下發記錄
    "fee": 1 //扣費的數量
}

					
 


1 協議說明

協議 HTTP POST
編碼格式 UTF8
URL https://live.kewail.com/sms/v1/sendvoice
接口說明 給用戶發語音通知(支持中文、英文字母、數字及組合,內容長度不超過100字)。
注:accesskey請填寫您在Kewail上申請到的,random請填成隨機數。

請求的樣例如下: https://live.kewail.com/sms/v1/sendvoice?accesskey=xxxxx&random=xxxxx
2 請求包體

包體為json字符串,參數如下:

		{
    "tel": {
        "nationcode": "86", //國家碼
        "mobile": "13788888888" //手機號碼
    }, 
    "prompttype": 2, //語音類型,目前固定為2
    "promptfile": "語音內容文本", //通知內容,utf8編碼,支持中文英文、數字及組合,需要和語音內容模版相匹配
    "playtimes": 2, //播放次數,可選,最多3次,默認2次
    "sig": "30db206bfd3fea7ef0db929998642c8ea54cc7042a779c5a0d9897358f6e9505", //app憑證,具體計算方式見下注
    "time": 1457336869, //unix時間戳,請求發起時間,如果和系統時間相差超過10分鐘則會返回失敗
    "ext": "", //用戶的session內容,Kewailserver回包中會原樣返回,可選字段,不需要就填空。
}

					
									

注:
1、"sig"字段根據公式sha256(secretkey=$accesskey&random=$random&time=$time&mobile=$mobile)生成
偽代碼如下:

 
string strMobile = "13788888888"; //tel的mobile字段的內容
string strsecretkey = "dffdfd6029698a5fdf4"; //accesskey對應的accesskey,需要業務方高度保密
string strRand = "7226249334"; //url中的random字段的值
string strTime = "1457336869"; //unix時間戳
string sig = sha256(secretkey=$strsecretkey&random=$strRand&time=$strTime&mobile=$strMobile);

					
3 應答包體
 
{
    "result": 0, //0表示成功,非0表示失敗
    "errmsg": "OK", //result非0時的具體錯誤信息
    "ext": "", //用戶的session內容,Kewailserver回包中會原樣返回
    "callid": "xxxx" //標識本次發送id,標識一次下發記錄
}

					
 


1 協議說明

協議 HTTP POST
編碼格式 UTF8
URL https://live.kewail.com/sms/v1/saveTemplate
接口說明 添加短信(或語音)模板
注:accesskey請填寫您在Kewail上申請到的,random請填成隨機數。

請求的樣例如下: https://live.kewail.com/sms/v1/saveTemplate?accesskey=xxxxx&random=xxxxx
2 請求包體

包體為json字符串,參數如下:

		{
	"accesskey": "xxxxx", //accesskey ,可登陸系統查看
    "sig": "30db206bfd3fea7ef0db929998642c8ea54cc7042a779c5a0d9897358f6e9505", //app憑證,具體計算方式見下注
    "time": 1457336869, //unix時間戳,請求發起時間,如果和系統時間相差超過10分鐘則會返回失敗
    "remark": "xxxxx", //模板備注,比如申請原因,使用場景等,可選字段
    "content": "xxxxx", //模板內容
}

					
									

注:
"sig"字段根據公式sha256(secretkey=$accesskey&random=$random&time=$time)生成
偽代碼如下:


string secretkey = "dffdfd6029698a5fdf4"; //accesskey對應的secretkey,需要業務方高度保密
string random = "7226249334"; //url中的random字段的值
string time = "1457336869"; //unix時間戳
string sig = sha256(secretkey=$secretkey&random=$random&time=$time);
3 應答包體
 
{
    "result": 0, //0表示成功,非0表示失敗
    "errmsg": "", //result非0時的具體錯誤信息
    "data": {
        "_id": 123, //模板id
        "content": "xxxxx", //模板內容
        "status": 1, //0:待審核;1:已通過;2:已拒絕
        "userId": xxx //用戶Id
    }
}

					
 


1 協議說明

協議 HTTP POST
編碼格式 UTF8
URL https://live.kewail.com/sms/v1/updateTemplate
接口說明 修改短信(或語音)模板
注:accesskey請填寫您在Kewail上申請到的,random請填成隨機數。

請求的樣例如下: https://live.kewail.com/sms/v1/updateTemplate?accesskey=xxxxx&random=xxxxx
2 請求包體

包體為json字符串,參數如下:

		{
    "sig": "30db206bfd3fea7ef0db929998642c8ea54cc7042a779c5a0d9897358f6e9505", //app憑證,具體計算方式見下注
    "time": 1457336869, //unix時間戳,請求發起時間,如果和系統時間相差超過10分鐘則會返回失敗
    "content": "xxxxx", //新的模板內容
    "templateId": 123, //待修改的模板的模板id
}

					
									

注:
"sig"字段根據公式sha256(secretkey=$accesskey&random=$random&time=$time)生成
偽代碼如下:


string secretkey = "dffdfd6029698a5fdf4"; //accesskey對應的accesskey,需要業務方高度保密
string random = "7226249334"; //url中的random字段的值
string time = "1457336869"; //unix時間戳
string sig = sha256(secretkey=$secretkey&random=$random&time=$time);
3 應答包體
 
{
    "result": 0, //0表示成功,非0表示失敗
    "errmsg": "", //result非0時的具體錯誤信息
    "data": {
        "_id": 123, //模板id
        "content": "xxxxx", //模板內容
        "status": 1, //0:待審核 1:已通過;;2:已拒絕
        "userId": xx //用戶Id
    }
}

					
 


1 協議說明

協議 HTTP POST
編碼格式 UTF8
URL 舉例:
接口說明 刪除短信(或語音)模板
注:accesskey請填寫您在Kewail上申請到的,random請填成隨機數。
2 請求包體

包體為json字符串,參數如下:

		{
    "sig": "30db206bfd3fea7ef0db929998642c8ea54cc7042a779c5a0d9897358f6e9505", //app憑證,具體計算方式見下注
    "time": 1457336869, //unix時間戳,請求發起時間,如果和系統時間相差超過10分鐘則會返回失敗
    "tpl_id": [123, 124...] //模板id,也可以通過值指定一個"tpl_id":123
}

					
									

注:
"sig"字段根據公式sha256(secretkey=$accesskey&random=$random&time=$time)生成
偽代碼如下:


string strAppkey = "dffdfd6029698a5fdf4"; //accesskey對應的accesskey,需要業務方高度保密
string strRand = "7226249334"; //url中的random字段的值
string strTime = "1457336869"; //unix時間戳
string sig = sha256(secretkey=$strAppkey&random=$strRand&time=$strTime);
3 應答包體
 
{
    "result": 0, //0表示成功,非0表示失敗
    "msg": "" //result非0時的具體錯誤信息
}

					
 


1 協議說明

協議 HTTP POST
編碼格式 UTF8
URL https://live.kewail.com/sms/v1/findTemplate
接口說明 查詢申請的短信(或語音)模板狀態
注:accesskey請填寫您在Kewail上申請到的,random請填成隨機數。

請求的樣例如下: https://live.kewail.com/sms/v1/findTemplate?accesskey=xxxxx&random=xxxxx
2 請求包體

包體為json字符串,參數如下:

		{
    "sig": "30db206bfd3fea7ef0db929998642c8ea54cc7042a779c5a0d9897358f6e9505", //app憑證,具體計算方式見下注
    "time": 1457336869, //unix時間戳,請求發起時間,如果和系統時間相差超過10分鐘則會返回失敗
    "templateId": 123 //查詢指定模版id的信息
       
}
	
									

注:
"sig"字段根據公式sha256(secretkey=$accesskey&random=$random&time=$time)生成
偽代碼如下:


string secretkey = "dffdfd6029698a5fdf4"; //accesskey對應的accesskey,需要業務方高度保密
string random = "7226249334"; //url中的random字段的值
string time = "1457336869"; //unix時間戳
string sig = sha256(secretkey=$secretkey&random=$random&time=$time);
3 應答包體
 
{
    "result": 0, //0表示成功,非0表示失敗
    "errmsg": "", //result非0時的具體錯誤信息
    "data": 
        {
            "_id": 123, //模板id
            "content": "xxxxx", //模板內容
            "status": 0, //0:待審核;1:已通過;2:已拒絕
            "userId": 0 //用戶Id
        }
    
}

					
 


1 協議說明

協議 HTTP POST
編碼格式 UTF8
URL 舉例:
接口說明 添加短信簽名
注:accesskey請填寫您在Kewail上申請到的,random請填成隨機數。
2 請求包體

包體為json字符串,參數如下:

		{
    "sig": "30db206bfd3fea7ef0db929998642c8ea54cc7042a779c5a0d9897358f6e9505", //app憑證,具體計算方式見下注
    "time": 1457336869, //unix時間戳,請求發起時間,如果和系統時間相差超過10分鐘則會返回失敗
    "remark": "xxxxx", //簽名備注,比如申請原因,使用場景等,可選字段
    "text": "xxxxx" //簽名內容,不帶【】,例如:【Kewail科技】這個簽名,這里填"Kewail科技"
}

									

注:
"sig"字段根據公式sha256(secretkey=$accesskey&random=$random&time=$time)生成
偽代碼如下:


string strAppkey = "dffdfd6029698a5fdf4"; //accesskey對應的accesskey,需要業務方高度保密
string strRand = "7226249334"; //url中的random字段的值
string strTime = "1457336869"; //unix時間戳
string sig = sha256(secretkey=$strAppkey&random=$strRand&time=$strTime);
3 應答包體
 
{
    "result": 0, //0表示成功,非0表示失敗
    "msg": "", //result非0時的具體錯誤信息
    "data": {
        "id": 123, //簽名id
        "text": "xxxxx", //簽名內容
        "status": 1, //0:已通過;1:待審核;2:已拒絕
    }
}

					
 


1 協議說明

協議 HTTP POST
編碼格式 UTF8
URL 舉例:
接口說明 修改短信簽名
注:accesskey請填寫您在Kewail上申請到的,random請填成隨機數。
2 請求包體

包體為json字符串,參數如下:

		{
    "sig": "30db206bfd3fea7ef0db929998642c8ea54cc7042a779c5a0d9897358f6e9505", //app憑證,具體計算方式見下注
    "time": 1457336869, //unix時間戳,請求發起時間,如果和系統時間相差超過10分鐘則會返回失敗
    "remark": "xxxxx", //新的簽名備注,比如申請原因,使用場景等,可選字段
    "text": "xxxxx", //新的簽名內容,不帶【】,例如:改為【Kewail科技】這個簽名,這里填"Kewail科技"
    "sign_id": 123 //待修改的簽名對應的簽名id
}

									

注:
"sig"字段根據公式sha256(secretkey=$accesskey&random=$random&time=$time)生成
偽代碼如下:


string strAppkey = "dffdfd6029698a5fdf4"; //accesskey對應的accesskey,需要業務方高度保密
string strRand = "7226249334"; //url中的random字段的值
string strTime = "1457336869"; //unix時間戳
string sig = sha256(secretkey=$strAppkey&random=$strRand&time=$strTime);
3 應答包體
 
{
    "result": 0, //0表示成功,非0表示失敗
    "msg": "", //result非0時的具體錯誤信息
    "data": {
        "id": 123, //簽名id
        "text": "xxxxx", //簽名內容
        "status": 1, //0:已通過;1:待審核;2:已拒絕
    }
}

					
 


1 協議說明

協議 HTTP POST
編碼格式 UTF8
URL 舉例:
接口說明 刪除短信簽名
注:accesskey請填寫您在Kewail上申請到的,random請填成隨機數。
2 請求包體

包體為json字符串,參數如下:

		{
    "sig": "30db206bfd3fea7ef0db929998642c8ea54cc7042a779c5a0d9897358f6e9505", //app憑證,具體計算方式見下注
    "time": 1457336869, //unix時間戳,請求發起時間,如果和系統時間相差超過10分鐘則會返回失敗
    "sign_id": [123, 124...] //簽名id,也可以通過值指定一個"sign_id":123
}

									

注:
"sig"字段根據公式sha256(secretkey=$accesskey&random=$random&time=$time)生成
偽代碼如下:


string strAppkey = "dffdfd6029698a5fdf4"; //accesskey對應的accesskey,需要業務方高度保密
string strRand = "7226249334"; //url中的random字段的值
string strTime = "1457336869"; //unix時間戳
string sig = sha256(secretkey=$strAppkey&random=$strRand&time=$strTime);
3 應答包體
 
{
    "result": 0, //0表示成功,非0表示失敗
    "msg": "" //result非0時的具體錯誤信息
}

					
 


1 協議說明

協議 HTTP POST
編碼格式 UTF8
URL 舉例:
接口說明 查詢申請的短信簽名狀態
注:accesskey請填寫您在Kewail上申請到的,random請填成隨機數。
2 請求包體

包體為json字符串,參數如下:

		{
    "sig": "30db206bfd3fea7ef0db929998642c8ea54cc7042a779c5a0d9897358f6e9505", //app憑證,具體計算方式見下注
    "time": 1457336869, //unix時間戳,請求發起時間,如果和系統時間相差超過10分鐘則會返回失敗
    "sign_id": [123, 124...] //簽名id,也可以通過值指定一個"sign_id":123
}

									

注:
"sig"字段根據公式sha256(secretkey=$accesskey&random=$random&time=$time)生成
偽代碼如下:


string strAppkey = "dffdfd6029698a5fdf4"; //accesskey對應的accesskey,需要業務方高度保密
string strRand = "7226249334"; //url中的random字段的值
string strTime = "1457336869"; //unix時間戳
string sig = sha256(secretkey=$strAppkey&random=$strRand&time=$strTime);
3 應答包體
 
{
    "result": 0, //0表示成功,非0表示失敗
    "msg": "", //result非0時的具體錯誤信息
    "count": 3, //result為0時有效,返回的信息條數,信息內容在data字段中
    "data": [
        {
            "id": 123, //簽名id
            "text": "xxxxx", //簽名內容
            "status": 0, //0:已通過;1:待審核;2:已拒絕
            "reply": "xxxxx" // 審批信息,如果status為2,會說明拒絕原因
        },...
    ]
}

					
 


1 協議說明

協議 HTTP POST
編碼格式 UTF8
URL 舉例:
接口說明 拉取一段時間短信發送狀態(發送量,成功量,計費條數)
注:accesskey請填寫您在Kewail上申請到的,random請填成隨機數。
2 請求包體

包體為json字符串,參數如下:

		{
    "sig": "30db206bfd3fea7ef0db929998642c8ea54cc7042a779c5a0d9897358f6e9505", //app憑證,具體計算方式見下注
    "time": 1457336869, //unix時間戳,請求發起時間,如果和系統時間相差超過10分鐘則會返回失敗
    "begin_date": 2016090800, //yyyymmddhh需要拉取的起始時間,精確到小時
    "end_date": 2016090823 //yyyymmddhh需要拉取的截止時間,精確到小時
}

									

注:
"sig"字段根據公式sha256(secretkey=$accesskey&random=$random&time=$time)生成
偽代碼如下:


string strAppkey = "dffdfd6029698a5fdf4"; //accesskey對應的accesskey,需要業務方高度保密
string strRand = "7226249334"; //url中的random字段的值
string strTime = "1457336869"; //unix時間戳
string sig = sha256(secretkey=$strAppkey&random=$strRand&time=$strTime);
3 應答包體
 
{
    "result": 0, //0表示成功,非0表示失敗
    "errmsg": "OK", //result非0時的具體錯誤信息
    "data": { //result為0時有效 
        "request": 101, //短信提交量
        "success": 100, //短信提交成功量
        "bill_number": 120 // 短信計費條數,比如提交成功量中有20條是長短信80個字節,拆分成2條,計費條數=80*1+20*2=120條
    }
}

					
 


1 協議說明

協議 HTTP POST
編碼格式 UTF8
URL 舉例:
接口說明 拉取一段時間短信回執狀態(提交成功量,回執量,回執成功量,回執失敗量及失敗分布)
注:accesskey請填寫您在Kewail上申請到的,random請填成隨機數。
2 請求包體

包體為json字符串,參數如下:

		{
    "sig": "30db206bfd3fea7ef0db929998642c8ea54cc7042a779c5a0d9897358f6e9505", //app憑證,具體計算方式見下注
    "time": 1457336869, //unix時間戳,請求發起時間,如果和系統時間相差超過10分鐘則會返回失敗
    "begin_date": 2016090800, //yyyymmddhh需要拉取的起始時間,精確到小時
    "end_date": 2016090823 //yyyymmddhh需要拉取的截止時間,精確到小時
}

									

注:
"sig"字段根據公式sha256(secretkey=$accesskey&random=$random&time=$time)生成
偽代碼如下:


string strAppkey = "dffdfd6029698a5fdf4"; //accesskey對應的accesskey,需要業務方高度保密
string strRand = "7226249334"; //url中的random字段的值
string strTime = "1457336869"; //unix時間戳
string sig = sha256(secretkey=$strAppkey&random=$strRand&time=$strTime);
3 應答包體
 
{
    "result": 0, //0表示成功,非0表示失敗
    "errmsg": "OK", //result非0時的具體錯誤信息
    "data": { //result為0時有效
        "success": 100, //短信提交成功量
        "status": 90, //短信回執量
        "status_success": 80, //短信回執成功量
        "status_fail": 10, //短信回執失敗量
        "status_fail_0": 2, //運營商內部錯誤
        "status_fail_1": 2, //號碼無效或空號
        "status_fail_2": 2, //停機、關機等
        "status_fail_3": 2, //黑名單
        "status_fail_4": 2 //運營商頻率限制
    }
}

					
 


1 協議說明

 


進入短信控制臺,點擊左側的統計數據按鈕后,可以看到您發送短信的統計分析。

1 數據總覽

在選定應用后,您可以查看今天、昨天、最近7天,最近30天或指定時間段的短信發送量和發送成功率。

2 短信查詢

在選定應用后,可以查看單個手機號在指定時間段的短信下發記錄。

3 模版查詢

在選定應用,輸入模版ID后,可查看指定時間內該模版的短信發送量和發送成功率。

 


1 短信發送錯誤碼

錯誤碼原因解決方案
1001sig校驗失敗請核對API的sig格式說明
1002短信/語音內容中含有敏感詞應答包會返回該敏感詞,請去掉該敏感詞后重新發送
1003請求包體沒有sig字段或sig為空請遵守API接口說明規范
1004請求包解析失敗,通常情況下是由于沒有遵守API接口說明規范導致的可參考1004錯誤詳解
1006請求沒有權限,比如沒有擴展碼權限等請查看錯誤提示語說明,如還有問題請提供失敗手機號聯系客服
1007其他錯誤請查看錯誤提示語說明,如還有問題請提供失敗手機號聯系客服
1008請求下發短信/語音超時出現概率很低,可重試解決
1009請求ip不在白名單中您配置了校驗請求來源ip,但是檢測到當前請求ip不在配置列表中,如有需要請聯系客服
1011不存在該REST API接口請核查REST API接口說明
1012簽名格式錯誤或者簽名未審批簽名只能由中英文、數字組成,要求2~8個字;如果符合簽名格式規范,請核查簽名是否已審批
1013下發短信/語音命中了頻率限制策略可自行到控制臺調整短信頻率限制策略;語音如有需要請聯系客服
1014模版未審批或請求的內容與審核通過的模版內容不匹配可參考1014錯誤詳解
1015手機號在黑名單庫中,通常是用戶退訂或者命中運營商黑名單導致的可聯系客服解決
1016手機號格式錯誤請核查下發短信/語音的用戶手機號格式是否正確
1017請求的短信內容太長短信內容長度超過限制,請調整短信長度
1018語音驗證碼格式錯誤請遵守API接口說明規范
1019accesskey不存在
1020accesskey已禁用此accesskey禁止提供服務,如有需要請聯系客服
1021請求發起時間不正常,通常是由于您的服務器時間與Kewail服務器時間差異超過10分鐘導致的請核對服務器時間及API接口中的時間字段是否正常
1022業務短信日下發條數超過設定的上限可自行到控制臺調整短信頻率限制策略
1023單個手機號30秒內下發短信條數超過設定的上限可自行到控制臺調整短信頻率限制策略
1024單個手機號1小時內下發短信條數超過設定的上限可自行到控制臺調整短信頻率限制策略
1025單個手機號日下發短信條數超過設定的上限可自行到控制臺調整短信頻率限制策略
1026單個手機號下發相同內容超過設定的上限可自行到控制臺調整短信頻率限制策略
1027商業或事務發送沒有投遞量請購買套餐
1028json參數錯誤請檢查發送的json參數

2 狀態回執錯誤碼

代碼分類原因解決方案
DELIVRD三網用戶短信接收成功
MX:0003三網單個手機號碼當天下行條數超過該簽名日上限請聯系客服解除限制
REJECTD三網短消息因某種原因被拒絕請核實手機終端是否處于正常狀態
MX:0012三網目標號碼在客戶退訂黑名單中用戶回復上行退訂信息后加黑的,請聯系客服解除黑名單
MX:0011三網目標號碼在禁1年黑名單中禁1年黑名單中的號碼均為惡意投訴號碼,或是多次投訴的高危號碼
BWLIST _006三網網關黑名單
UNDELIV移動空號、停機或關機請核實手機終端是否處于正常狀態
MI:0013移動停機或關機
MN:0001移動空號、停機或關機請核實手機終端是否處于正常狀態
MK:0012移動空號請核實手機終端是否處于正常狀態
MK:0005移動該短消息的被叫用戶的開戶數據的21號增值業務屬性是否支持如號碼狀態正常,可請用戶自行撥打當地運營商客服電話確認手機端短信業務是否開啟
MK:0005移動呼叫被禁止。該用戶的短消息業務被禁止了。在維測臺中的錯誤值為5。在ETSI GSM 0902協議中定義為13。請核實手機終端是否處于正常狀態
MK:0000移動號碼為空號請核實手機終端是否處于正常狀態
MN:0054移動空號、停機或關機請核實手機終端是否處于正常狀態
MK:0001移動MK0001是HLR查無此號,短信中心返回狀態為無法識別被叫號碼。說明用戶發送的號碼有誤請核實手機終端是否處于正常狀態
EXPIRED移動短消息超過有效期手機終端長時間未響應,導致短信接收失敗
MI:0024移動停機或關機
MI:0011移動空號、停機或關機
MC:0151移動空號、停機或關機
IC:0001移動停機或關機
MI:0029移動停機或關機
MI:0005移動空號、停機或關機
MK:0004移動停機或關機
MI:0000移動空號、停機或關機
MI:0022移動移動網關的內部錯誤請核實手機終端是否處于正常狀態
IA:0054移動超時未接收到響應消息請核實手機終端是否處于正常狀態,可請用戶重啟手機后再次測試看看
MC:0055移動由于用戶不在服務區或內存滿導致發送失敗請核實手機終端是否處于正常狀態
MN:0059移動空號、停機或關機請核實手機終端是否處于正常狀態
MN:0036移動用戶當時不在服務區請核實手機終端是否處于正常狀態,主要為用戶端忙碌導致短信下發失敗
MI:0004移動空號、停機或關機
MI:0020移動空號、停機或關機
MK:0029移動暫時無法接通請核實手機終端是否處于正常狀態
MI:0084移動空號、停機或關機
MK:0024移動下發短消息時,目的手機關機,導致該短消息下發失敗。請核實手機終端是否處于正常狀態
MK00001移動手機終端是空號請核實手機終端是否處于正常狀態
MI:0017移動空號、停機或關機
MK:0015移動下發短消息時,手機在接收過程出現軟件問題。例如,手機重啟后,處理短消息部分軟件沒有初始化完成,此時無法正常處理短消息。請核實手機終端是否處于正常狀態
MN:0029移動空號、停機或關機請核實手機終端是否處于正常狀態
IC:0151移動空號、停機或關機請核實手機終端是否處于正常狀態
MN:0075移動運營商內部錯誤
MK:0010移動暫時無法接通請核實手機終端是否處于正常狀態
IC:0015移動運營商內部錯誤
BEYONDN移動運營商內部錯誤
MI:0055移動空號、停機或關機
MI:0010移動號碼已失效
MC00151移動運營商內部錯誤
IC:0055移動運營商內部錯誤
MB:1078移動運營商內部錯誤請提供具體號碼給客服,下工單向運營商核實
MN00001移動運營商內部錯誤
ID:0013移動運營商內部錯誤
MC:0001移動未知錯誤
MK:0017移動手機內存滿。手機保存短消息的空間已滿,需要清除保存的短消息,釋放空間。
MI:0081移動運營商內部錯誤
DA:0054移動超時未接收到響應消息請核實手機終端是否處于正常狀態
MB:1042移動SMC內存中緩存的、要下發給被叫用戶的短消息數超過了該用戶的最大下發數。檢查該被叫號碼在SMC內存中的短消息積壓情況。若達到了該被叫實體的最大下發數,請稍后再提交。
ERR_NUM移動被叫號碼不正確或被限制請核實手機終端是否處于正常狀態
MI:0054移動空號、停機或關機
MK:0011移動停機或關機
MN:0052移動運營商內部錯誤
MK:0008移動用戶當前所在地區信號不好,無法接收短消息。請核實手機終端是否處于正常狀態
IA:0073移動運營商內部錯誤
IA:0051移動運營商內部錯誤
MK:0075移動空號、停機或關機請核實手機終端是否處于正常狀態
MN:0022移動空號、停機或關機請核實手機終端是否處于正常狀態
MN:0020移動移動網關的內部錯誤請核實手機終端是否處于正常狀態
MI00029移動運營商內部錯誤
MI:0008移動移動網關的內部錯誤
MI:0012移動非法設備請核實手機終端是否處于正常狀態
MN:0012移動空號、停機或關機請核實手機終端是否處于正常狀態
MI:0059移動空號、停機或關機
MN:0050移動空號、停機或關機請核實手機終端是否處于正常狀態
MN:0017移動短消息被拒絕請核實手機終端是否處于正常狀態
MI:0045移動移動網關的內部錯誤
MN:0055移動運營商內部錯誤
NOROUTE移動查找路由失敗
MI:0036移動移動網關的內部錯誤
MB:1077移動黑名單,用戶在移動公司有惡意投訴記錄需要用戶自己與移動運營商10086溝通解除
MK:0020移動運營商內部錯誤
MK:0022移動運營商內部錯誤
MN:0053移動運營商內部錯誤
DB:0505移動運營商內部錯誤
ID:0070移動運營商內部錯誤
MX:0002移動向上級通道提交短信失敗
DB:0141移動曾多次投訴移動或者工信部的黑名單無法解除
MA:0051移動運營商內部錯誤
IB:0008移動運營商內部錯誤
MI00000移動消息在短信中心過期
DB:0164移動運營商黑名單
MK:0013移動空號
DB:0144移動用戶在全局黑名單中
BWLIST移動網關黑名單請聯系客服解除黑名單
HD:19移動網關黑名單請聯系客服解除黑名單
MI00020移動短信下發手機終端失敗ErrorinMS
MI:0041移動運營商內部錯誤
MC:0055_006移動由于用戶不在服務區或內存滿導致發送失敗請核實手機終端是否處于正常狀態
MI:0064移動運營商內部錯誤
ERR_NUM_006移動被叫號碼不正確或被限制請核實手機終端是否處于正常狀態
MI:0057移動運營商內部錯誤
MI:0056移動響應超時請核實手機終端是否處于正常狀態
MN:0098移動運營商內部錯誤
MK:0036移動來自MSC的未知錯誤。
MN:0019移動運營商內部錯誤
MI:0030移動運營商內部錯誤
MI:0023移動運營商內部錯誤
MI:0002移動運營商內部錯誤
MK:0019移動MS不支持短消息終呼業務請核實手機終端是否處于正常狀態
IB:0064移動關機請核實手機終端是否處于正常狀態
MB:1026移動SMC的相關運行參數(如MO速度、MT速度、短消息數、短消息實體數)已經達到了License的最大限制。請稍后再嘗試提交消息。
MK:0055移動運營商內部錯誤
MK:0066移動運營商內部錯誤
MI00022移動手機終端內存滿請核實手機終端是否處于正常狀態
IB:0009移動運營商內部錯誤
MK:0006移動運營商內部錯誤
MK:0053移動運營商內部錯誤
MK:0023移動運營商內部錯誤
MK:0045移動運營商內部錯誤
MC:0055_000移動由于用戶不在服務區或內存滿導致發送失敗請核實手機終端是否處于正常狀態
MA:0054移動運營商內部錯誤請提供具體號碼給客服,下工單向運營商核實
MK:0041移動運營商內部錯誤
MK:0063移動運營商內部錯誤
ID:0012移動計費地址錯誤請核實手機終端是否處于正常狀態
MK:0084移動HLR返回收到未預期響應請提供具體號碼給客服,下工單向運營商核實
MB:0088移動運營商內部錯誤
MI00036移動運營商內部錯誤
DB00144移動目的號碼在全局黑名單被攔截
MA:0073移動請提供具體號碼給客服,下工單向運營商核實
MI:0099移動vmsc返回收到未預期響應請核實手機終端是否處于正常狀態
MI:0089移動運營商內部錯誤
MI:0063移動運營商內部錯誤
MI:0090移動vmsc返回遠端地址不可達請核實手機終端是否處于正常狀態
MN00013移動機終端停機請核實手機終端是否處于正常狀態
DB:0107移動運營商內部錯誤
IB:0255移動運營商內部錯誤
MA:0022移動運營商內部錯誤
IB:0013移動運營商內部錯誤
MA:0001移動運營商內部錯誤
MK:0065移動GIW超時無應答
MN:0009移動運營商內部錯誤
UNKNOWN移動未知的短消息狀態
DB:0010移動運營商內部錯誤
MK:0021移動運營商內部錯誤
MI:0038移動運營商內部錯誤
MI:0052移動漫游限制
MK:0003移動非法用戶。本次短消息發送過程中,用戶鑒權未通過,可能的原因是MSC認為該手機的鑒權密碼非法。在維測臺中的錯誤值為3。在ETSI GSM 0902協議中定義為9。
MK:0009移動用戶不在服務區MWDSET。
MK:0051移動運營商內部錯誤
MK:0068移動運營商內部錯誤
DB:0106移動服務代碼錯誤
MB:1031移動短信中心回的,超出最大發送次數 可能是手機滿了。請核實手機終端是否處于正常狀態
MI:0048移動運營商內部錯誤
MK00011移動手機終端沒有短信業務"請核實手機終端是否處于正常狀態
MK:0048移動運營商內部錯誤
MK:0056移動運營商內部錯誤
MK:0057移動運營商內部錯誤
MK:0088移動vmsc返回潛在的版本不匹配
TUIDING移動運營商黑名單
HIGRISK移動運營商黑名單請聯系客服解除黑名單
CA:0054移動移動內部錯誤
MN:0041移動當前手機處于關機、無法接通等異常狀態
MK:0090移動當前手機狀態處于停機、暫時無法接通等異常狀態
XL:169移動手機號碼為空號或不存在
MN:xxxx移動M開頭的移動錯誤代碼是指Mobile,大多是因為手機端問題導致。原因有:關機,停機,信號弱,不在服務區,無效號碼等等。
MK:xxxx移動M開頭的移動錯誤代碼是指Mobile,大多是因為手機端問題導致。原因有:關機,停機,信號弱,不在服務區,無效號碼等等。
MI:xxxx移動M開頭的移動錯誤代碼是指Mobile,大多是因為手機端問題導致。原因有:關機,停機,信號弱,不在服務區,無效號碼等等。
12聯通計費地址錯(空號、關機、停機、通話被限制或者轉到聯通秘書)請核實手機終端是否處于正常狀態
1聯通空號、號碼不存在請核實手機終端是否處于正常狀態
10聯通Src_ID錯(空號、關機、停機、通話被限制或者轉到聯通秘書)請核實手機終端是否處于正常狀態
24聯通計費號碼無效(用戶不在使用)請核實手機終端是否處于正常狀態
5聯通號碼已停機請核實手機終端是否處于正常狀態
29聯通手機用戶信息錯誤請確認手機號碼狀態是否為正確狀態
13聯通業務代碼未分配,根據MT話單里的接入號和業務代碼找不到對應的申報項請核實手機終端是否處于正常狀態,如正常可請用戶致電聯通客服確認號碼的短信業務是否開通
93聯通月租鑒權失敗(用戶已經停機或銷戶)請核實手機終端是否處于正常狀態
11聯通運營商內部錯誤
4聯通手機關機請核實手機終端是否處于正常狀態
54聯通用戶已關機請核實手機終端是否處于正常狀態
59聯通運營商內部錯誤請提供具體號碼給客服,下工單向運營商核實
15聯通號碼不在服務區請核實手機終端是否處于正常狀態
23聯通運營商內部錯誤請提供具體號碼給客服,下工單向運營商核實
27聯通手機不支持短消息請核實手機終端是否處于正常狀態,如正常可請用戶致電聯通客服確認號碼的短信業務是否開通
W-BLACK聯通號碼為全局黑名單請提供具體號碼給客服解除黑名單
17聯通運營商內部錯誤
51聯通用戶已關機請核實手機終端是否處于正常狀態
-37聯通用戶已關機請核實手機終端是否處于正常狀態
20聯通暫時停機請核實手機終端是否處于正常狀態
55聯通號碼不在服務區請核實手機終端是否處于正常狀態
67聯通號碼是空號請核實手機終端是否處于正常狀態
95聯通鑒權失敗因為用戶銷戶或不存在請核實手機終端是否處于正常狀態
22聯通運營商內部錯誤
90聯通運營商內部錯誤
-74聯通運營商內部錯誤
2聯通運營商內部錯誤
104聯通運營商內部錯誤
92聯通請提供具體號碼給客服,下工單向運營商核實
86聯通號碼不在服務區
50聯通停機
8聯通信息長度錯
57聯通運營商內部錯誤
79聯通內存滿請核實手機終端是否處于正常狀態
53聯通用戶已關機請核實手機終端是否處于正常狀態
3聯通運營商內部錯誤
255聯通請提供具體號碼給客服,下工單向運營商核實
100聯通請提供具體號碼給客服,下工單向運營商核實
61聯通號碼是空號請核實手機終端是否處于正常狀態
117聯通請提供具體號碼給客服,下工單向運營商核實
45聯通號碼停機請核實手機終端是否處于正常狀態
164聯通請提供具體號碼給客服,下工單向運營商核實
46聯通請提供具體號碼給客服,下工單向運營商核實
14聯通運營商內部錯誤
9聯通非法序列號,包括序列號重復、序列號格式錯誤等請核實手機終端是否處于正常狀態
69聯通黑名單用戶
89聯通號碼不在服務區請核實手機終端是否處于正常狀態
64聯通號碼不在服務區請核實手機終端是否處于正常狀態
88聯通號碼不在服務區請核實手機終端是否處于正常狀態
98聯通暫時停機請核實手機終端是否處于正常狀態
18聯通用戶未訂購請核實手機終端是否處于正常狀態,如正常可請用戶致電聯通客服確認號碼的短信業務是否開通
36聯通號碼停機請核實手機終端是否處于正常狀態
44聯通手機無短信功能請核實手機終端是否處于正常狀態,如正常可請用戶致電聯通客服確認號碼的短信業務是否開通
99聯通暫時停機請核實手機終端是否處于正常狀態
43聯通內存滿請核實手機終端是否處于正常狀態
-43聯通內存滿請核實手機終端是否處于正常狀態
118聯通手機無短信功能請核實手機終端是否處于正常狀態,如正常可請用戶致電聯通客服確認號碼的短信業務是否開通
52聯通手機終端無短信接收功能請核實手機終端是否處于正常狀態,如正常可請用戶致電聯通客服確認號碼的短信業務是否開通
31聯通非法設備請核實手機終端是否處于正常狀態,如正常可請用戶致電聯通客服確認號碼的短信業務是否開通
75聯通號碼限制請核實手機終端是否處于正常狀態,如正常可請用戶致電聯通客服確認號碼的短信業務是否開通
103聯通請提供具體號碼給客服,下工單向運營商核實
56聯通欠費停機請核實手機終端是否處于正常狀態
106聯通非法費用,鑒權失敗
-1聯通運營商內部錯誤
19聯通用戶未訂購
148聯通運營商內部錯誤
48聯通運營商內部錯誤
63聯通運營商內部錯誤
73聯通運營商內部錯誤
70聯通號碼不在服務區請核實手機終端是否處于正常狀態
32聯通運營商內部錯誤
40聯通運營商內部錯誤
110聯通運營商內部錯誤
116聯通運營商內部錯誤
21聯通運營商內部錯誤
219聯通用戶手機終端處于關機、停機、暫時無法接聽等不正常狀態導致手機無法接收到短信
182聯通用戶手機終端已暫停服務
124聯通用戶手機終端處于關機、通話被限制、暫停服務等異常狀態
101聯通手機號碼為空號
105聯通當前手機狀態處于停機、暫停服務、呼入被限制等異常情況
213聯通當前手機狀態處于停機、暫停服務、呼入被限制等異常情況
72聯通145號段空號或者不存在
LT:0002聯通因信號原因導致聯通失敗。若批量失敗則有可能是內容敏感詞導致,需和運營商確認
UNDELIV_601電信用戶因為狀態不正確如處于停機、掛起等狀態而導致用戶無法接收到短信請核實手機終端是否處于正常狀態
EXPIRED_602電信用戶因為狀態不正確如處于停機、掛起等狀態而導致用戶無法接收到短信請核實手機終端是否處于正常狀態
UNDELIV_640電信用戶因為狀態不正確如處于停機、掛起等狀態而導致用戶無法接收到短信請核實手機終端是否處于正常狀態
REJECTD_006電信短消息因為某種原因被拒絕請核實短信是否為行業短信,如是,可以請用戶致電聯通客服確認號碼的短信業務是否開通
UNDELIV_705電信用戶因為狀態不正確如處于停機、掛起等狀態而導致用戶無法接收到短信請核實手機終端是否處于正常狀態
EXPIRED_760電信用戶因為狀態不正確如處于停機、掛起等狀態而導致用戶無法接收到短信請核實手機終端是否處于正常狀態
EXPIRED_601電信用戶因為狀態不正確如處于停機、掛起等狀態而導致用戶無法接收到短信請核實手機終端是否處于正常狀態
UNDELIV_869電信用戶因為狀態不正確如處于停機、掛起等狀態而導致用戶無法接收到短信請核實手機終端是否處于正常狀態
UNDELIV_999電信請提供具體號碼給客服,下工單向運營商核實
UNDELIV_602電信用戶因為狀態不正確如處于停機、掛起等狀態而導致用戶無法接收到短信請核實手機終端是否處于正常狀態
UNDELIV_614電信用戶因為狀態不正確如處于停機、掛起等狀態而導致用戶無法接收到短信請核實手機終端是否處于正常狀態
EXPIRED_660電信用戶因為狀態不正確如處于停機、掛起等狀態而導致用戶無法接收到短信請核實手機終端是否處于正常狀態
UNDELIV_713電信請提供具體號碼給客服,下工單向運營商核實
UNDELIV_615電信請提供具體號碼給客服,下工單向運營商核實
EXPIRED_702電信用戶因為狀態不正確如處于停機、掛起等狀態而導致用戶無法接收到短信請核實手機終端是否處于正常狀態
EXPIRED_640電信用戶因為狀態不正確如處于停機、掛起等狀態而導致用戶無法接收到短信請核實手機終端是否處于正常狀態
REJECTD_706電信短消息因為某種原因被拒絕請核實短信是否為行業短信,如是,可以請用戶致電聯通客服確認號碼的短信業務是否開通
EXPIRED_615電信短消息因為某種原因被拒絕請核實手機終端是否處于正常狀態
UNDELIV_765電信請提供具體號碼給客服,下工單向運營商核實
UNDELIV_870電信運營商內部錯誤
UNDELIV_899電信請提供具體號碼給客服,下工單向運營商核實
EXPIRED_001電信請提供具體號碼給客服,下工單向運營商核實
UNDELIV_612電信請提供具體號碼給客服,下工單向運營商核實
UNDELIV_714電信請提供具體號碼給客服,下工單向運營商核實
UNDELIV_702電信用戶因為狀態不正確如處于停機、掛起等狀態而導致用戶無法接收到短信請核實手機終端是否處于正常狀態
UNDELIV_815電信用戶因為狀態不正確如處于停機、掛起等狀態而導致用戶無法接收到短信請核實手機終端是否處于正常狀態
UNDELIV_771電信用戶因為狀態不正確如處于停機、掛起等狀態而導致用戶無法接收到短信請核實手機終端是否處于正常狀態
UNDELIV_711電信用戶因為狀態不正確如處于停機、掛起等狀態而導致用戶無法接收到短信請核實手機終端是否處于正常狀態
UNDELIV_627電信用戶因為狀態不正確如處于停機、掛起等狀態而導致用戶無法接收到短信請核實手機終端是否處于正常狀態
UNDELIV_814電信用戶因為狀態不正確如處于停機、掛起等狀態而導致用戶無法接收到短信請核實手機終端是否處于正常狀態
UNDELIV_660電信用戶因為狀態不正確如處于停機、掛起等狀態而導致用戶無法接收到短信請核實手機終端是否處于正常狀態
EXPIRED_612電信運營商內部錯誤
UNDELIV_613電信用戶因為狀態不正確如處于停機、掛起等狀態而導致用戶無法接收到短信請核實手機終端是否處于正常狀態
UNDELIV_619電信用戶因為狀態不正確如處于停機、掛起等狀態而導致用戶無法接收到短信請核實手機終端是否處于正常狀態
UNDELIV_680電信用戶因為狀態不正確如處于停機、掛起等狀態而導致用戶無法接收到短信請核實手機終端是否處于正常狀態
UNDELIV_636電信用戶因為狀態不正確如處于停機、掛起等狀態而導致用戶無法接收到短信請核實手機終端是否處于正常狀態
UNDELIV_726電信用戶因為狀態不正確如處于停機、掛起等狀態而導致用戶無法接收到短信請核實手機終端是否處于正常狀態
UNDELIV_718電信用戶因為狀態不正確如處于停機、掛起等狀態而導致用戶無法接收到短信請核實手機終端是否處于正常狀態
UNDELIV_880電信用戶因為狀態不正確如處于停機、掛起等狀態而導致用戶無法接收到短信請核實手機終端是否處于正常狀態
UNDELIV_634電信用戶因為狀態不正確如處于停機、掛起等狀態而導致用戶無法接收到短信請核實手機終端是否處于正常狀態
EXPIRED_010電信短消息超過有效期手機終端超時未響應
EXPIRED_619電信短消息超過有效期手機終端超時未響應
EXPIRED_999電信短消息超過有效期手機終端超時未響應
UNDELIV_001電信用戶因為狀態不正確如處于停機、掛起等狀態而導致用戶無法接收到短信請核實手機終端是否處于正常狀態
UNDELIV_620電信用戶因為狀態不正確如處于停機、掛起等狀態而導致用戶無法接收到短信請核實手機終端是否處于正常狀態
EXPIRED_614電信運營商內部錯誤
EXPIRED_618電信運營商內部錯誤
EXPIRED_613電信運營商內部錯誤
EXPIRED_617電信運營商內部錯誤
UNDELIV_701電信空號、停機或關機
UNDELIV_701電信空號、停機或關機
UNDELIV_802電信空號、停機或關機
UNDELIV_801電信空號、停機或關機
UNDELIV電信/聯通用戶因為狀態不正確如處于停機、掛起等狀態而導致用戶無法接收到短信
MOBILE BLACK電信/聯通號碼為全局黑名單請聯系客服解除黑名單
其他電信/聯通運營商未公布原因請提供具體號碼給客服,下工單向運營商核實
 


1 短信、語音價格

短信根據長度按條計費,語音按實際通話分鐘數計費(不足一分鐘,按一分鐘計算)。
國內短信、語音實行階梯收費,月結后付費模式。量級越大,價格越優惠,詳情請聯系客服
海外短信,支持200多個不同國家和地區,不同國家價格不一樣,詳情請點擊海外短信價格

2 短信長度

單次發送的短信(含簽名)長度不要超過450字(漢字,字符,數字等可見符號,都按1個字計算)。單條短信長度為70字,超過70字后,按67字/條分隔成多條, 以長短信的方式發送給用戶,即用戶收到的是一條短信,但是按多條計費。

3 短信簽名

短信簽名是附加在短信內容前面的標識,用于標識公司或業務。短信簽名由【】及簽名內容組成,簽名內容要求2~8個字(由中英文,數字組成,不能包含其他特殊字符,如“+,@,|等”), 例如Kewail的短信簽名為“【Kewail】”。短信簽名需要在移動運營商備案,需要您提供企業的營業執照正本或副本復印件(要加蓋企業公章),如有疑問請咨詢客服

4 短信內容

默認情況下,需要在Kewail控制臺申請內部模版備案后,才可以發送短信給用戶。內部模版示例如下:
{1}為您的登錄驗證碼,請于{2}分鐘內填寫。如非本人操作,請忽略本短信。
如您的短信業務量很大,想自定義短信內容,請咨詢客服, 審核通過后,短信內容可以省去備案流程。(注:營銷類短信內容一定需要備案)

5 短信接入審核規則

您在Kewail短信控制臺申請短信簽名或內容模版后, 會有專門同事進行審核,正常情況下,1個工作日會反饋審核結果。如果您急需使用短信功能, 請咨詢客服, 我們會加速審核進度。
如果審核未通過(如沒有提交過營業執照復印件,短信簽名不符合要求, 短信內容中含有敏感詞等),也可 咨詢客服進行詳細溝通。

6 多個簽名如何發送短信

如果您有多個短信簽名,請將需要的短信簽名放在 短信內容前面,然后調用短信接口進行發送。
例如您有"【Kewail科技】"," 【Kewail】"兩個簽名,但是您想以"【Kewail】"簽名發送短信,則發送內容可賦值為: "【Kewail】你的驗證碼是xxxx"。(其中"xxxx"為下發的驗證碼)

7 通知短信與營銷短信區別

通知短信:也即行業短信,指通過一定的客戶端向不同的客戶發送手機短信的業務, 短信內容一般為驗證碼信息、觸發類信息、內部通知等不帶營銷字眼的短信。
示例1:{1}為您的登錄驗證碼,請于{2}分鐘內填寫。如非本人操作,請忽略本短信。
示例2:您{1}的信用訂單本期已成功還款{2}元,可用授信額度已恢復至{3}元,感謝您的使用。
示例3:備案訂單{1}提交的郵寄材料已通過審核,請盡快提交{2},如已提交Kewail將盡快審核。
營銷短信:指短信內容一般為經營性公司向網站、公司注冊會員下發促銷、會員活動信息等明顯營銷類推廣短信。 (強調:營銷類短信內容后面,要添加“回T退訂”)
示例1:好消息!明星店鋪可以通過{1}申請了,品牌亮起來, 人氣旺起來,超多免費物料等你拿!趕緊來申請!回T退訂
示例2:年后補貨讓利瘋搶第{1}波! 美發專場低至{2}折!{3}限時開搶,猛戳:{4}。回T退訂

8 查詢單個手機發送記錄

當您的客戶反饋收不到短信,或者您想查看用戶手機的短信發送狀態,您可以在Kewail短信控制臺的“統計數據-短信查詢”頁面查詢,如下所示:

9 用戶沒有收到短信

首先確認下調用接口后是否返回成功,如果返回成功,再確認下狀態報告中的狀態是否為成功 (也可在Kewail短信控制臺查詢短信下發狀態)。
如果返回失敗,則可以查看應答包的失敗原因說明, 如請求次數過多命中了頻率控制策略,短信內容格式不正確(比如雙簽名,或者有敏感詞),手機在黑名單中等 。
如果返回成功,但是用戶沒有收到,則存在以下幾種場景:
1、用戶手機關機,欠費或者停機,可以通過撥打手機確認;
2、用戶手機狀態不穩定(如信號不好),可以讓用戶確認下信號是否正常,必要時重啟下手機;
3、用戶手機收件箱滿,可以讓用戶刪除多余的短信,然后再重試確認下;
4、短信被用戶手機中的安全軟件屏蔽了,可以讓用戶確認是否在屏蔽列表中;
5、如果以上場景都不滿足,請 咨詢客服解決。

10 手機黑名單

當用戶收到不想收到的短信時,可能會投訴或者退訂等,此時我們會把用戶的手機加入到運營黑名單中。 后續下發短信時,如果匹配了黑名單,將不會給用戶的手機下發短信,避免對用戶的騷擾。
如果您的客戶反饋收不到短信,并確認是黑名單導致的,可 聯系客服申請解除黑名單。

11 1004錯誤詳解

調用Kewail短信接口發送短信時,如果應答包返回1004錯誤,可通過以下方式定位解決:
1、確認發送的請求是否是標準的json格式,聯系 客服可以校驗一下;
2、檢查是否有將單引號當做雙引號使用(json標準應該是雙引號);
3、檢查參數名稱是否寫錯(打字時可能打錯);
4、檢查請求的字段類型和API中描述的字段類型是否一致,是否存在弄混了json字符串和json整型的情況,
例如:{"姓名":"小明", "年齡":23},"姓名"為json字符串,"年齡"為json整型;
5、檢查對API的調用是否和官網描述的一致,例如:使用群發短信的API但是包體的格式是單發短信的;

12 1014錯誤詳解

調用Kewail短信接口發送短信時,如果應答包返回1014錯誤,可通過以下方式定位解決:
1、確認申請的內容模版格式是否正確,如內容模版中的“{}”為英文的括號,括號中的數字需從1開始連續編號, 如{1},{2}……
2、確認請求內容對應的模版是否審批通過;
3、確認請求包中type參數的值(0表示通知短信,1表示營銷短信)與申請的內容模版類型是否一致;
4、確認請求的內容與申請的內容模版格式是否一致,特別要留意是否有空格等不可見字符 導致的不匹配;
5、如果內容中含有中文,請確認中文是utf-8編碼;

13 60008錯誤詳解

調用Kewail短信接口發送短信時,如果應答包返回60008錯誤,可通過以下方式定位解決:
1、如果請求在1s內響應60008錯誤碼,請確認請求格式是否是標準HTTP格式;
2、確認dns配置是否正常,確保使用的是公網dns server;
3、推薦業務使用http長連接,并使用連接池,以提升網絡質量;
4、如果還是無法解決, 請聯系客服

14 短信頻率限制

對于驗證碼、通知類短信,同一號碼同一內容30秒內最多發送1條; 對于營銷類短信, 同一號碼同一內容24小時內最多發送3條,同一號碼不同內容24小時內最多發送15條。

15 短信結算

Kewail采用后付費的方式與業務方進行短信費用結算。每月5日前, Kewail會向您提供上月短信的詳細賬單,經您確認無誤后,需要您支付上月的短信費用 ,Kewail會為您出具有效發票。
對于后付費服務,為避免壞賬,會在月結后, 按上個月后付費結算金額的 120% 進行凍結。 次月結算日時,先對凍結費用解凍,再扣費,再按后付費結算金額的 120% 凍結。

16 短信賬單

每月5日前,Kewail會向您提供上月短信的詳細賬單,您可以在Kewail的“用戶中心-費用中心-收支明細” 的短信類別下面查看短信費用消耗,點擊“用量報表”會為您展示對應月份短信的每日用量, 同時您可以導出報表數據用于財務報帳和存底等用途,如下圖:

17 充值與發票

您可以參考充值 中的指引進行充值;在支付Kewail短信費用后,可按照 發票管理中的指引申請對應金額的發票。

 


如有其它疑問,請@Kewail短信技術支持,QQ 2403602442,電子郵箱[email protected]

3d试机号走势图彩宝网