建立PP一元簡訊 API 功能，您可以透過HTTP請求發送網址參數的方式，將簡訊內容經由PP一元簡訊進行發送。
如果尚未建立PP API KEY，請由下方按鈕建立一個API KEY。
尚未申請
查詢點數 - 詳細參數列表:
發送網址： https://pp.url.com.tw/api/balance
| 參數名稱 | 參數說明 |
|---|---|
| api_key | 簡訊發送 API 金鑰 |
| user_name | 智邦會員中心帳號 |
| password | 智邦會員中心密碼 |
查詢簡訊發送狀態 - 詳細參數列表:
發送網址： https://pp.url.com.tw/api/status
| 參數名稱 | 參數說明 |
|---|---|
| api_key | 簡訊發送 API 金鑰 |
| user_name | 智邦會員中心帳號 |
| uniqid | API 回傳的簡訊發送編號 |
查詢簡訊發送狀態 PHP 範例:
$login = curl_init("https://pp.url.com.tw/api/status");
// 智邦 PP 簡訊 API 的發送網址
$post_string = array(
'api_key' => '226b6f589768572981c65a40bcc7a07c',
'user_name' => 'url_pp',
'uniqid' => '69986B65-15D4-43',
);
curl_setopt($login, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($login, CURLOPT_POST, 1);
curl_setopt($login, CURLOPT_POSTFIELDS, $post_string);
curl_setopt($login, CURLOPT_HTTP_VERSION, CURL_HTTP_VERSION_1_1);
$r = curl_exec($login);
eval('$c='.$r.';');
if ($c['status']=='OK') {
echo 'Success';
} else {
echo $c['message'];
}
查詢簡訊狀態回傳參數
| 參數名稱 | 參數說明 |
|---|---|
| status | 回傳查詢簡訊狀態有無成功。 系統會回傳 OK / NO |
| message | 發送成功 |
| 發送等待中 當用戶手機無回應時，系統會 Retry 發送 |
|
| 發送失敗 | |
| 取消發送 |
發送簡訊 - 詳細參數列表:
發送網址： https://pp.url.com.tw/api/msg
| 參數名稱 | 參數說明 |
|---|---|
| api_key | 簡訊發送 API 金鑰 |
| user_name | 智邦會員中心帳號 |
| password | 智邦會員中心密碼 |
| sms_list | 發送簡訊的手機。 |
| sms_body | 發送簡訊的內容 (簡訊內容支援長簡訊)。 計費方式 中文字 70 字 / 英文字 140 字視為一則簡訊，內容須為UTF-8編碼 若要透過 API 發送換行字元請使用 \n 做換行字元 (換行字元會占一個字元) |
| sms_time | 預約發送簡訊 請將預約時間設定大於十分鐘以上。 |
發送簡訊 PHP 範例:
$login = curl_init("https://pp.url.com.tw/api/msg");
// 智邦 PP 簡訊 API 的發送網址
$post_string = array(
'api_key' => '226b6f589768572981c65a40bcc7a07c',
'user_name' => 'url_pp',
'password' => '**********',
'sms_list' => '0912345678',
'sms_body' => 'TEST SMS MESSAGE',
'sms_time' => '2011-01-01 12:45:00'
);
curl_setopt($login, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($login, CURLOPT_POST, 1);
curl_setopt($login, CURLOPT_POSTFIELDS, $post_string);
curl_setopt($login, CURLOPT_HTTP_VERSION, CURL_HTTP_VERSION_1_1);
$r = curl_exec($login);
eval('$c='.$r.';');
if ($c['status']=='OK') {
echo 'Success';
} else {
echo $c['message'];
}
發送簡訊 ASP 範例:
<%
Set objSvrHTTP = Server.Createobject("MSXML2.ServerXMLHTTP")
objSvrHTTP.open "POST", "http://pp.url.com.tw/api/msg", false
dim data
data = "api_key=226b6f589768572981c65a40bcc7a07c&user_name=url_pp
&password=********&sms_list=0912345678&sms_body=TEST SMS
MESSAGE&sms_time=2011-01-01 12:45:00"
objSvrHTTP.setRequestHeader "Content-Type", "application/x-www-form-urlencoded"
objSvrHTTP.setRequestHeader "Content-Length", Len(data)
objSvrHTTP.send(data)
Response.Write objSvrHTTP.responseBody
%>
Java/JSP/C# 範例:
使用 Java / JSP / C# 呼叫PP簡訊API的範例程式，請點此下載。
發送簡訊回傳參數
| 參數名稱 | 參數說明 |
|---|---|
| status | 回傳簡訊發送有無成功。 系統會回傳 OK / NO |
| message | 發送成功 |
| 請確認你的 API KEY 是否存在!! | |
| 錯誤的使用者名稱或密碼!! | |
| 請填寫簡訊內容!! | |
| 請輸入接收門號!! 多人的門號以「,」做為間格 |
|
| 請填寫正確的收訊者名單!! | |
| 單次簡訊發送限制 (單次發送簡訊的限制為 250 則) |
|
| 點數不足!!請補充點數! (加值) | |
| 當使用點數查詢時，則是顯示 "剩餘點數" | |
| uniqid | 簡訊發送編號 透過查詢網址可查詢簡訊狀態 |
