建立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 | 簡訊發送編號 透過查詢網址可查詢簡訊狀態 |