| 範例條件 | 代入內容 |
| username | api01(帳號) |
| password | api01(密碼) |
| dstaddr | 0933853653 (十位數字門號或加國碼的國際門號) |
| smbody | 【簡訊王api測試】70個中英數標點混合為一則簡訊。可使用enter 以及空格 全形數字１２３以及長達335個字的長簡訊。 |
| dlvtime | 建議設定為0 秒，可使用,YYYY/MM/DD hh24:mm:ss,格式設定 |
| vldtime | 可不代入此參數 (不設定有效期限將使用預設值28800秒 ) |
| response | http://回報網址/response.php (可不代入此參數) |
https://api.kotsms.com.tw/kotsmsapi-1.php?username=帳號&password=密碼&dstaddr=0933853653&
smbody=簡訊王api簡訊測試 &response=http://回報網址/response.php
kmsgid=5091933&dstaddr=0961000001&dlvtime=20070101120000&donetime=
20070101120010&statusstr=DELIVRD (不限於只有這些Tag，擴充用，詳見表二)
response.php接收回報程式範例：(此檔案不需額外製作己附於壓縮檔內 )
<?php
$res="kmsgid=".$_REQUEST[“kmsgid”]."\tdstaddr=".$_REQUEST[“dstaddr”]."\tdlvtime=".
$_REQUEST[“dlvtime”]."\tdonetime=".$_REQUEST[“donetime”]."&\tstatusstr=".$_REQUEST[“statusstr”];
$fp = fopen("retccmoapi.txt","a+");
fwrite( $fp, $res);
fclose($fp);
?>
3.錯誤代碼（kmsgid）表一
-1 | CGI string error ，系統維護中或其他錯誤 ,帶入的參數異常,伺服器異常 |
| -2 | 授權錯誤(帳號/密碼錯誤) |
| -4 | A Number違反規則 發送端 870短碼VCSN 設定異常 |
| -5 | B Number違反規則 接收端 門號錯誤 - |
| -6 | Closed User 接收端的門號停話異常090 094 099 付費代號等 |
| -20 | Schedule Time錯誤 預約時間錯誤 或時間已過 |
| -21 | Valid Time錯誤 有效時間錯誤 |
| -1000 | 發送內容違反NCC規範 |
| -59999 | 帳務系統異常 簡訊無法扣款送出 |
| -60002 | 您帳戶中的點數不足 |
| -60014 | 該用戶已申請 拒收簡訊平台之簡訊 ( 2010 NCC新規) |
| -999959999 | 在12 小時內，相同容錯機制碼 |
| -999969999 | 同秒, 同門號, 同內容簡訊 |
| -999979999 | 鎖定來源IP |
| -999989999 | 簡訊為空 |
常見SMSC訊息狀況摘錄－表二
Message State | Final Message States |
Description
|
DELIVERED
|
DELIVRD
| 成功發送 確定該手機已收到簡訊且回應狀態。 |
EXPIRED
|
EXPIRED
| 逾時未達 該門號手機一直未開機、或收不到訊號，系統已重複發送8~24小時，仍然無法傳送簡訊給該門號。 |
DELETED
|
DELETED
| 刪除簡訊 指該簡訊違反台灣現有法規(禁用字)，此簡訊已被系統刪除，將不再發送。 |
UNDELIVERABLE
|
UNDELIV
| 無法投遞 可能是簡訊收件夾已滿或無法於8~24小時內重複發送…等問題。 |
ACCEPTED
|
ACCEPTD
| 發送失敗 電信業者回覆告知發送失敗。此狀態為該簡訊送達門號有異常，例如:空號、停話、號碼不存在…等。※簡訊內容出現NCC規定【禁用字】時,將造成『全數發送失敗』※ |
UNKNOWN
|
UNKNOWN
| 未知情形 此狀態為系統商與系統商之間資料交換失敗皆統稱未知情形。 |
REJECTED
|
REJECTD
| 拒收簡訊 該接收門號拒收簡訊。 |
SYNTAXERROR
|
SYNTAXE
| 語法錯誤 發送簡訊語法錯誤，編碼錯誤或發送號碼為付費手機門號(0948)…等。 |
註記：發送狀態"紅色字樣" 皆不予計費
Final Message States為Phase II中statusstr的值
簡訊發送點數計算方式
70個字以內-----扣1點
134個字以內----扣2點
201個字以內----扣3點
268個字以內----扣4點
335個字以內----扣5點
若使用長簡訊發送時，當其中一則發送失敗時，該筆簡訊將判定為發送失敗，點數全部補回。
國際簡訊以3倍計點 (70個字以內------扣3點….依此類推)
<?
if( strlen(trim($_REQUEST["sUserName"]))>0 && strlen(trim($_REQUEST["sPassword"]))>0 && strlen(trim($_REQUEST["sTelNo"]))>0 && strlen(trim($_REQUEST["sMessage"]))>0 ){
//$msg="username=".$_REQUEST["sUserName"]."&password=".$_REQUEST["sPassword"]."&dstaddr=".$_REQUEST["sTelNo"]."&smbody=".$_REQUEST["sMessage"];
$msg="username=testapi01&password=testapi&dstaddr=".$_REQUEST["sTelNo"]."&smbody=".$_REQUEST["sMessage"];
$host="202.39.48.216";
$to_url="http://".$host."/kotsmsapi-1.php?".$msg;
if (!$getfile=file($to_url)){
echo "<br><br><br><br><center>ERROR:無法連接</center>";
exit;
}
$term_tmp = implode ('', $getfile);
$term=$term_tmp;
echo $term;
}
?>
