Bahasa
English
筛选菜单

夢網國際短訊平台API說明（V5.13）



1. API簡介


夢網雲通訊平台API是夢網憑藉多年的開發經驗，專為用戶提供的簡單易用的API調用服務，皆在為第三方開發者在應用內快速、高效、低成本集成夢網雲通訊平台的各項業務提供了一站式服務。


API採用了當前流行的REST風格設計和實現，簡潔易懂，支持多種主流開發語言的調用，支持JSON、XML、x-www-form-urlencoded三種資料傳遞方式，使用者可以根據實際的開發需求選擇合適的數據傳遞方式，兼容了大部分使用者對API的需求。


企業客戶可通過調用Send_single API，向夢網短訊網關提交短訊。夢網網關將短訊發送給手機客戶後，夢網網關會生成描述短訊是否發送成功的狀態報告，企業客戶可通過以下兩種方式獲取狀態報告：1）主動調用get_rpt，獲取短訊發送結果的狀態報告。2）被動接收由夢網網關主動推送的狀態報告。（企業客戶需提供接收狀態報告的URL地址）。


詳細的各API報文的參數描述如下：



2.1 單條發送API send_single


2.1.1 請求URL

http://ip:port/sms/v2/std/send_single

具體夢網網關的服務IP和 port，將在開通賬號時一併提供。


2.1.2 請求方式

POST/GET


2.1.3 請求參數說明

參數

類型

是否必須

描述

示例

userid

string

是

用戶帳號：長度最大6個字符，統一大寫

示例：J10003

pwd

string

是

加密後的用戶密碼：定長小寫32位字符。密碼規則詳見“3.1 鑒權規則”

密碼生成規則示例：

帳號：J10003

密碼：111111

固定字符串：00000000

時間戳：0803192020

MD5加密之前的對應字符串：

J10003000000001111110803192020

MD5加密之後的密碼字符串：

26dad7f364507df18f3841cc9c4ff94d

mobile

string

是

短訊接收的手機號：只能填一個手機號。 號碼規則詳見“3.2 手機號碼規則”

示例：85292041234

content

string

是

短訊內容：最大支持1000個字。使用UrlEncode編碼UTF-8的訊息內容。

示例：

短訊內容：“您本次登錄的驗證碼是1234”

短訊內容進行urlencode編碼後：

%E2%80%9C%E6%82%A8%E6%9C%AC%E6%AC%A1%E7%99%BB%E5%BD%95%E7%9A%84%E9%AA%8C%E8%AF%81%E7%A0%81%E6%98%AF1234%E2%80%9D

timestamp

string

否

時間戳：24小時制格式：MMDDHHMMSS,即月日時分秒，定長10位,月、日、時、分、秒每段不足2位時左補0

示例：0803192020

svrtype

string

否

業務類型：描述本條短訊的內容類別型，屬於驗證碼、通知、或營銷

驗證碼類：填寫為“1”

通知類：填寫為“2”

營銷類：填寫為“3”

exno

string

否

填寫本條短訊的OA或SenderID。可留空。

senderid

示例：MontSMS

custid

string

否

用戶自定義序列號：該條短訊在您業務系統內的ID，比如訂單號或者短訊發送記錄的序列號。填寫後發送狀態返回值內將包含用戶自訂義序列號。

最大可支援64位的ASCII字符串：字母、數字、底線、減號，如不需要則不用提交此字段或填空

示例：b3d0a2783d31b21b8573

exdata

string

否

自定義擴展資料：額外提供的最大64個長度的ASCII字符串：字母、數字、底線、減號，作為自訂擴展數據，填寫後，狀態報告返回時將會包含這部分數據,如不需要則不用提交此字段或填空


2.1.4 Post請求示例


urlencod 

 userid=J10003&pwd=26dad7f364507df18f3841cc9c4ff94d&mobile=85292041234&content=%e9%aa%8c%e8%af%81%e7%a0%81%ef%bc%9a6666%ef%bc%8c%e6%89%93%e6%ad%bb%e9%83%bd%e4%b8%8d%e8%a6%81%e5%91%8a%e8%af%89%e5%88%ab%e4%ba%ba%e5%93%a6%ef%bc%81×tamp=0803192020&svrtype=1&exno=0006&custid=b3d0a2783d31b21b8573&exdata=exdata000002


JSON 

 {"userid":"J10003","pwd":"26dad7f364507df18f3841cc9c4ff94d","mobile":"85292041234","content":"%e9%aa%8c%e8%af%81%e7%a0%81%ef%bc%9a6666%ef%bc%8c%e6%89%93%e6%ad%bb%e9%83%bd%e4%b8%8d%e8%a6%81%e5%91%8a%e8%af%89%e5%88%ab%e4%ba%ba%e5%93%a6%ef%bc%81","timestamp":"0803192020","svrtype":"1","exno":"0006","custid":"b3d0a2783d31b21b8573","exdata":"exdata000002"}


XML 

 

	J10003
26dad7f364507df18f3841cc9c4ff94d 
85292041234
%e9%aa%8c%e8%af%81%e7%a0%81%ef%bc%9a6666%ef%bc%8c%e6%89%93%e6%ad%bb%e9%83%bd%e4%b8%8d%e8%a6%81%e5%91%8a%e8%af%89%e5%88%ab%e4%ba%ba%e5%93%a6%ef%bc%81
0803192020
1
0006
b3d0a2783d31b21b8573
exdata000002


2.1.5 GET請求示例


URLENCODE 

 userid=J10003&pwd=26dad7f364507df18f3841cc9c4ff94d&mobile=85292041234&content=%e9%aa%8c%e8%af%81%e7%a0%81%ef%bc%9a6666%ef%bc%8c%e6%89%93%e6%ad%bb%e9%83%bd%e4%b8%8d%e8%a6%81%e5%91%8a%e8%af%89%e5%88%ab%e4%ba%ba%e5%93%a6%ef%bc%81×tamp=0803192020&svrtype=1&exno=0006&custid=b3d0a2783d31b21b8573&exdata=exdata000002


2.1.6 返回參數說明


夢網網關收到企業客戶提交的發送短訊報文後，將向企業客戶返回接收回應報文，格式如下：

參數

類型

描述

示例

result

int

短訊發送請求處理結果：

0：成功

非0：失敗，詳見4 錯誤代碼表

示例：0

desc

string

應答結果描述，當result非0時，為錯誤描述

編碼方式：urlencode(UTF-8)

示例：

“鑒權失敗”

urlencode(UTF-8)編碼：

%e9%89%b4%e6%9d%83%e5%a4%b1%e8%b4%a5

msgid

long

(64位)

短訊序列號：非0，64位整型，對應Java和C#的long，不可用int解析。result非0時，msgid為0

示例：9223372036854775808

custid

string

用戶自定義序列號：默認與請求報文中的custid保持一致，若請求報文中沒有custid參數或值為空，則返回由夢網生成的代表本批短訊的唯一編號result非0時，custid為空

示例：b3d0a2783d31b21b8573


2.1.7 發送成功返回示例


JSON (urlencode與JSON請求都以JSON返回數據) 

 {
"result":0,
"desc":%e6%88%90%e5%8a%9f,
"msgid":9223372036854775808,
"custid":"b3d0a2783d31b21b8573"
}


XML 

 

0
%e6%88%90%e5%8a%9f
9223372036854775808
b3d0a2783d31b21b8573


2.1.8 發送失敗返回示例


JSON (urlencode與JSON請求都以JSON返回數據) 

 {
"result":-100999,
"desc":%e7%b3%bb%e7%bb%9f%e5%86%85%e9%83%a8%e9%94%99%e8%af%af,
"msgid":0,
"custid":""
}


XML 

 

-100999

%e7%b3%bb%e7%bb%9f%e5%86%85%e9%83%a8%e9%94%99%e8%af%af

0



2.2 獲取狀態報告API get_rpt


2.2.1 請求URL

http://ip:port/sms/v2/std/get_rpt

具體夢網網關的服務IP和 port，將在開通賬號時一並提供。


2.2.2 請求方式

POST/GET


2.2.3 請求參數說明

參數

類型

是否必須

描述

示例

userid

string

是

用戶帳號：長度最大6個字符，統一大寫

示例：J10003

pwd

string

是

加密後的用戶密碼：定長小寫32位字符。密碼規則詳見“3.1 鑒權規則”

密碼生成規則示例：

帳號：J10003

密碼：111111

固定字符串：00000000

時間戳：0803192020

MD5加密之前的對應字符串：

J10003000000001111110803192020

MD5加密之後的密碼字符串：

26dad7f364507df18f3841cc9c4ff94d

timestamp

string

否

時間戳：24小時制格式：MMDDHHMMSS,即月日時分秒，定長10位,月、日、時、分、秒每段不足2位時左補0，密碼選擇MD5加密方式時必填該參數，密碼選擇明文方式時則不用填寫

示例：0803192020

retsize

int

否

本次請求想要獲取的狀態報告最大條數。

最大500，超過500按500返回。小於等於0或不填時，系統返回默認條數，默認500條

示例：200


2.2.4 Post請求示例


urlencode 

 userid=J10003&pwd=26dad7f364507df18f3841cc9c4ff94d×tamp=0803192020&retsize=300


JSON 

 {"userid":"J10003","pwd":"26dad7f364507df18f3841cc9c4ff94d","timestamp":"0803192020","retsize":300}


XML 

 

	J10003
26dad7f364507df18f3841cc9c4ff94d 
0803192020
300


2.2.5 GET請求示例


URLENCODE 

 userid=J10003&pwd=26dad7f364507df18f3841cc9c4ff94d×tamp=0803192020&retsize=300


2.2.6 返回參數說明


夢網網關收到客戶端

參數

類型

描述

示例

result

int

獲取狀態報告請求處理結果：

0：成功

非0：失敗，詳見4 錯誤代碼表

示例：0

desc

string

應答結果描述，當result非0時，為錯誤描述

編碼方式：urlencode(GB2312)

示例：

“鑒權失敗”

urlencode(GB2312)編碼：

%e9%89%b4%e6%9d%83%e5%a4%b1%e8%b4%a5

rpts

string

result非0時rpts為空

格式見下表




rpts包結構參數說明：



參數

類型

描述

示例

msgid

long

(64位)

平台序列號：對應下行請求返回結果中的msgid

示例：9223372036854775808

注意：msgid允許出現負數

custid

string

用戶自訂序列號：對應下行請求時填寫的custid

示例：

b3d0a2783d31b21b8573

pknum

int

對於企業客戶提交的長短訊，夢網網關拆分並計費的條數。


pktotal

int

預留字段，客戶端無需處理。


mobile

string

手機號：號碼規則詳見“3.2 手機號碼規則”


countrycode

int

手機號的國際區號：-1表示無效號碼

示例：86

spno

string

空值，預留字段，客戶端無需處理


exno

string

發送短訊時填寫的SenderID

示例：MontSMS

stime

string

狀態報告對應的下行發送時間:

YYYY-MM-DD HH:MM:SS

示例：2016-08-04 17:38:59

rtime

string

狀態報告返回時間:

YYYY-MM-DD HH:MM:SS

示例：2016-08-04 17:39:01

status

int

接收狀態：

0:成功

非0:失敗

示例：0

errcode

string

狀態報告錯誤代碼

示例：DELIVRD

errdesc

string

狀態報告錯誤代碼的描述

編碼方式：

若鑒權成功，編碼方式與下發請求內容編碼方式相同，否則為urlencode（GBK明文）

示例：

遞交成功：success

遞交失敗：欠費

exdata

string

下行時填寫的exdata


表 7-3



2.2.7 獲取成功返回示例


JSON (urlencode與JSON請求都以JSON返回資料) 

 {
"result":0,
"desc":%e6%88%90%e5%8a%9f,
"rpts": [
{
"msgid":9223372045854775808,
"custid":"b3d0a2783d31b21b8573",
"pknum":1,
"pktotal":2,
"mobile":"138xxxxxxxx",
"countrycode":86,
"spno":"1000457890006",
"exno":"0006",
"stime":"2016-08-04 17:38:55",
"rtime":"2016-08-04 17:38:59",
"status":0,
"errcode":"DELIVRD",
"errdesc":"success",
"exdata":"exdata0002"
},
{
"msgid":9223372045854875809,
"custid":"b3d0a2783d31b21b8574",
"pknum":2,
"pktotal":2,
"mobile":"138xxxxxxxx",
"countrycode":86,
"spno":"1000457890006",
"exno":"0006",
"stime":"2016-08-04 17:38:55",
"rtime":"2016-08-04 17:38:59",
"status":0,
"errcode":"DELIVRD",
"errdesc":"success",
"exdata":"exdata0002"
}
]
}


XML 

 

0
%e6%88%90%e5%8a%9f

  
    9223372045854775808
b3d0a2783d31b21b8573
1
2
138xxxxxxxx
86
1000457890006
0006
2016-08-04 17:38:55
2016-08-04 17:38:59
0
DELIVRD
success
exdata0002


    9223372045854875809
b3d0a2783d31b21b8574
2
2
138xxxxxxxx
86
1000457890006
0006
2016-08-04 17:38:55
2016-08-04 17:38:59
0
DELIVRD
success
exdata0002



2.3 推送狀態報告API

2.3.1 功能說明


開通此API後，夢網網關將為您即時推送狀態報告。您需要提供一個url地址，接受http post請求。 該API一次最多推送500個狀態報告，為了不影響推送速度，建議接收到數據後立即回應，另外線程非同步處理業務邏輯。



2.3.2 推送方式
POST
數據格式：json


2.3.3 請求參數說明



參數

類型

是否必須

描述

示例

userid

string

是

用戶帳號：長度最大6個字節，統一大寫

示例：J10003

pwd

string

是

用戶密碼：定長小寫32位字符串。密碼規則詳見“3.1 鑒權規則”

密碼生成規則示例：

帳號：J10003

密碼：111111

固定字符串：00000000

時間戳：0803192020

MD5加密之前的對應字符串：

J10003000000001111110803192020

MD5加密之後的密碼字符串：

26dad7f364507df18f3841cc9c4ff94d

客戶端收到報文後，可對數據報進行鑒權，確認數據報來源為真實的夢網網關。

timestamp

string

否

時間戳：24小時制格式：MMDDHHMMSS,即月日時分秒，定長10位,月、日、時、分、秒每段不足2位時左補0，密碼選擇MD5加密方式時必填該參數

示例：0803192020

cmd

string

是

推送狀態報告請求命令:夢網網關填寫為RPT_REQ

示例：RPT_REQ

seqid

int

是

請求訊息序列號：夢網網關向客戶端推送狀態報告訊息的序列號。客戶端收到狀態報告推送後，向夢網網關返回接收回應包時，需要填寫相同的訊息序列號。

示例：1004

rpts

string

是

狀態報告。

格式見下表

rpts包結構參數說明：

參數

類型

描述

示例

msgid

long

(64位)

平台序列號：對應下行請求返回結果中的msgid

示例：9223372036854775808

注意：msgid允許出現負數

custid

string

用戶自定義序列號：對應下行請求時填寫的custid

示例：b3d0a2783d31b21b8573

pknum

int

對於企業客戶提交的長短訊，夢網網關拆分並計費的條數。

pktotal

int

預留字段，客戶端無需處理。(長短訊拆分的總條數)

mobile

string

手機號：號碼規則詳見“3.2 手機號碼規則”

countrycode

int

手機號的國際區號：-1表示無效號碼

示例：86

spno

string

空值，預留字段

exno

string

下行時填寫的exno

示例：MontSMS

stime

string

狀態報告對應的下行發送時間：

YYYY-MM-DD HH:MM:SS

示例：2016-08-04 17:38:59

rtime

string

狀態報告返回時間：

YYYY-MM-DD HH:MM:SS

示例：2016-08-04 17:39:01

status

int

接收狀態：

0：成功

非0：失敗

示例：0

errcode

string

狀態報告錯誤代碼

示例：DELIVRD

errdesc

string

狀態報告錯誤代碼的描述

編碼方式：

根據不同報文格式編碼：

XML/x-www-form-urlencoded:URELENCODE(UTF-8)

JSON:UTF-8

示例：

遞交成功：success

遞交失敗：欠費

exdata

string

下行時填寫的exdata



2.3.4 Post請求示例 

 {"userid":"J10003","pwd":"26dad7f364507df18f3841cc9c4ff94d","timestamp":"0803192020","cmd":"RPT_REQ","seqid":1004,"rpts":
[
    {
        "msgid": 9223372045854775808,
        "custid": "b3d0a2783d31b21b8573",
        "pknum": 1,
        "pktotal": 2,
        "mobile": "138xxxxxxxx",
        "countrycode": 86,
        "spno": "1000457890006",
        "exno": "0006",
        "stime": "2016-08-04 17:38:55",
        "rtime": "2016-08-04 17:38:59",
        "status": 0,
        "errcode": "DELIVRD",
        "errdesc": "success",
        "exdata": "exdata0002"
    },
    {
        "msgid": 9223372045854875808,
        "custid": "b3d0a2783d31b21b8573",
        "pknum": 1,
        "pktotal": 2,
        "mobile": "138xxxxxxxx",
        "countrycode": 86,
        "spno": "1000457890006",
        "exno": "0006",
        "stime": "2016-08-04 17:38:55",
        "rtime": "2016-08-04 17:38:59",
        "status": 0,
        "errcode": "DELIVRD",
        "errdesc": "success",
        "exdata": "exdata0002"
    }  


	]}


2.3.5 返回參數說明


客戶端收到夢網網關推送的狀態報告後，需要向夢網網關返回確認接收的回應，格式如下


參數

類型

是否必須

描述

示例

cmd

string

是

必須填RPT_RESP

RPT_RESP

seqid

int

是

與請求中的seqid保持一致

 

result

int

是

狀態報告請求處理結果：

0：成功

非0：失敗，詳見4 錯誤代碼表

表 10-3


2.3.6 推送成功返回示例 


 {
"cmd":"RPT_RESP",
"seqid":1004,
"result":0
}



2.3.7 推送失敗返回示例 


 {
"cmd":"RPT_RESP",
"seqid":1004,
"result": -100999
}



2.4相同內容群發API send_batch


2.4.1 請求URL


http://ip:port/sms/v2/std/send_batch
具體夢網網關的服務IP和Port，將在開通帳號時一併提供。


2.4.3 請求參數說明


參數

類型

是否必須

描述

示例

userid

string

是

用戶帳號：長度最大6個字符，統一大寫 

示例：J10003

pwd

string

是

加密後的用戶密碼：定長小寫32位字符。密碼規則詳見“3.1 鑒權規則”

密碼生成規則示例：

帳號：J10003

密碼：111111

固定字符串：00000000

時間戳：0803192020

MD5加密之前的對應字符串：

J10003000000001111110803192020

MD5加密之後的密碼字符串：

26dad7f364507df18f3841cc9c4ff94d

mobile

string

是

短訊接收的手機號：多個號碼使用逗號分隔，需要攜帶國家碼。 單次最多支持1000個號碼。號碼規則詳見“3.2 手機號碼規則”

示例：85292041234, 85292041235, 85292041236

content

string

是

短訊內容：最大支持1000個字。使用UrlEncode編碼UTF-8的訊息內容。

示例：

短訊內容：“您本次登錄的驗證碼是1234”

短訊內容進行urlencode編碼後：

%E2%80%9C%E6%82%A8%E6%9C%AC%E6%AC%A1%E7%99%BB%E5%BD%95%E7%9A%84%E9%AA%8C%E8%AF%81%E7%A0%81%E6%98%AF1234%E2%80%9D

timestamp

string

否

時間戳：24小時制格式：MMDDHHMMSS,即月日時分秒，定長10位,月、日、時、分、秒每段不足2位時左補0 

示例：0803192020

svrtype

string

否

業務類型：描述本條短訊的內容類別型，屬於驗證碼、通知、或營銷

驗證碼類：填寫為“1”

通知類：填寫為“2”

營銷類：填寫為“3”

exno

string

否

填寫本條短訊的OA或SenderID。可留空。

senderid

示例：MontSMS

custid

string

否

用戶自訂序列號：該條短訊在您業務系統內的ID，比如訂單號或者短訊發送記錄的序列號。填寫後發送狀態返回值內將包含用戶自定義序列號。

最大可支援64位的ASCII字符串：字母、數字、底線、減號，如不需要則不用提交此欄位或填空

示例：b3d0a2783d31b21b8573

exdata

string

否

自定義擴展資料：額外提供的最大64個長度的ASCII字符串：字母、數字、底線、減號，作為自定義擴展資料，填寫後，狀態報告返回時將會包含這部分資料,如不需要則不用提交此字段或填空


2.4.4 Post請求示例


JSON 


 {"userid":"J10003","pwd":"26dad7f364507df18f3841cc9c4ff94d","mobile":"85292041234,85292041235,85292041236","content":"%e9%aa%8c%e8%af%81%e7%a0%81%ef%bc%9a6666%ef%bc%8c%e6%89%93%e6%ad%bb%e9%83%bd%e4%b8%8d%e8%a6%81%e5%91%8a%e8%af%89%e5%88%ab%e4%ba%ba%e5%93%a6%ef%bc%81","timestamp":"0803192020","svrtype":"1","exno":"0006","custid":"b3d0a2783d31b21b8573","exdata":"exdata000002"}


2.4.5返回參數說明


夢網網關收到企業客戶提交的發送短訊報文後，將向企業客戶返回接收回應報文，格式如下：


父節點

參數

    類型

描述

示例

無

result

int

短訊發送請求處理結果：

0：成功

非0：失敗，詳見4 錯誤代碼表

示例：0

無

desc

string

應答結果描述，當result非0時，為錯誤描述

編碼方式：urlencode(UTF-8)

示例：

“鑒權失敗”

urlencode(UTF-8)編碼：

%e9%89%b4%e6%9d%83%e5%a4%b1%e8%b4%a5

無

messages

Object-array

訊息對象陣列，失敗時為空。

說明請見下表。

示例：

[

    {

    "mobile":"85292041234"

    "msgid":9223372036854775808

    },

    {

    "mobile":"85292041235"

    "msgid":9675808854733720223

    }

]


messages字段的說明


父節點

參數

    類型

描述

示例

無

mobile

string

短訊接收的手機號：攜帶國家碼。號碼規則詳見“3.2 手機號碼規則”

示例

85292041234

無

msgid

long

(64位)

短訊序列號：非0，64位無符號整型十進制數。result非0時，msgid為0

示例：9223372036854775808



2.4.6 發送成功返回示例


JSON (urlencode與JSON請求都以JSON返回數據) 


 {
"result":0,
"desc":%e6%88%90%e5%8a%9f,
"messages":[
    {
        "mobile":"85292041234"
        "msgid":9223372036854775808
    },
    {
        "mobile":"85292041235"
        "msgid":9675808854733720223
    }
]
}


2.4.7 發送失敗返回示例


JSON (urlencode與JSON請求都以JSON返回數據) 


 {
"result":-100999,
"desc":%e7%b3%bb%e7%bb%9f%e5%86%85%e9%83%a8%e9%94%99%e8%af%af,
"messages":[]
}

2.4.2 請求方式


POST
數據格式：json


3.1鑒權規則 


1. 帳號+密碼的密文值進行用戶鑒權 
userid填寫賬號明文，pwd的密碼加密方式如下：將userid值大寫、固定字符串00000000、明文pwd、timestamp依次拼接成字符串後，再進行MD5加密，userid和明文的pwd在夢網開戶時提供，timestamp為時間戳，24小時制，格式為：MMDDHHMMSS，即月日時分秒，定長10位，月、日、時、分、秒每段不足2位時左補0。
備註：時間戳請填寫發送時動態的準確時間，不要填寫固定值，否則時間誤差太大伺服器有可能拒絕您的請求。


3.2手機號碼規則


1. 每次請求所提交的號碼段類型不受限制，但系統會對每個手機號碼做合法性驗證，若有不合法的手機號碼，以失敗回應形式返回。
2.客戶發送短訊時，接收方號碼mobile字段規則需要符合以下3種格式之一：
（1）國際電話區號+手機號碼，例如85292041234
（2）00+或者國際電話區號+手機號碼，例如0085292041234

（3）”+”+國際電話區號+手機號碼，例如+85292041234


4. 錯誤代碼表


返回錯誤代碼

錯誤說明

-100001

鑒權不通過,請檢查帳號,密碼,時間戳,固定串,以及MD5算法是否按照文文件要求進行設置

-100002

用戶多次鑒權不通過,請檢查帳號,密碼,時間戳,固定串,以及MD5算法是否按照文文件要求進行設置

-100004

custid或者exdata字段填寫不合法

-100011

短訊內容超長

-100012

手機號碼不合法

-100014

手機號碼超過最大支持數量（1000）

-100056

用戶帳號登錄的連接數超限

-100057

使用者帳號登錄的IP錯誤

-100999

平台數據庫內部錯誤

-100807

號碼數量超限

-100268

請求訊息時間過期

-100269

定時時間格式錯誤

-100270

存活有效期格式錯誤

-100271

短訊內容為空

-100272

未匹配到短訊驗證碼

-100273

DSC為0時短訊內容格式不是ASCII碼

-100274

手機號碼不符合規則

-100100~-100090

請求報文體格式錯誤

 

5. 注意事項

1. 請求報文支持JSON，XML，x-www-form-urlencoded，用Content-type識別請求包報文的格式，如使用x-www-form-urlencoded時，格式如下： 


POST /sms/v2/std/single_send HTTP/1.1
Host: 192.168.1.1
Content-Type: application/x-www-form-urlencoded
Content-Length: length


2. 為確保能夠快速及時獲取到狀態報告，請在調用API後判斷API是否有狀態報告返回，若有返回，則需要一直獲取，直到API返回無數據時，延時5秒，然後再次重複前面的獲取和判斷操作。

3. 獲取狀態報告API get_rpt和推送狀態報告API，只能使用其中一個API獲取回調狀態報告。若使用了推送狀態報告API推送某條狀態報告，則再次使用get_rpt API，會獲取不到該條狀態報告。一般建議使用推送狀態報告API。
4. 單條發送API每次只能發送一個號碼，否則API返回失敗。
5. 單個發送賬號預設併發連結數為100個，如需調整增加並發連接數，請聯繫技術支撐人員。
6. 本API基於http協議， 適用於任何支持http協議的程式設計語言進行開發，如： C++，JAVA，C#，PHP，Python，NodeJS，R，JavaScript，Ruby，Go，Swift等其他的程式設計語言。


Pengalaman Kilat Detik

Integrasi Cepat 10 Menit

Siap Komersial dalam 2 Jam

SMS Teks

SMS Video

Hubungi Kami
Treasury Tower, Lantai 15 Unit L District 8 SCBD Lot. 28 Jalan Jenderal Sudirman Kavling 52-53, Desa/Kelurahan Senayan, Kec. Kebayoran Baru, Kota Adm. Jakarta Selatan, Provinsi DKI Jakarta, Kode Pos: 12190, Indonesia.
Copyright © Brisnets International Technology Co. All Rights Reserved
Kebijakan Privasi Perjanjian Lisensi Pengguna Akhir Syarat Layanan
Bahasa
English
Pesan Pelanggan

  • Nama Perusahaan*

  • Nomor Telepon Anda*

  • Nama Anda*

  • Email*

  • Produk Konsultasi*

    Semua Produk
    • Semua Produk
    • SMS A2P
    • Pesan 5G

  • Pesan*