|
輸入參數 |
※輸入參數請都先以UrlEncode過後再帶入、以避免因特殊字元造成的錯誤
|
名稱 |
描述 |
資料型態 |
註解 |
|
Ccid |
客戶證號 |
字串 |
最長為15位元的客戶證號 |
|
Key |
授權碼 |
字串 |
長度為36的授權碼字串 |
|
GsmNoArray |
車機門號清單 |
Array |
車輛門號清單、車機授權碼清單、車號清單必須選擇一個以上。
修正的車輛門號清單。
範例：更改參數的車機門號清單，則GsmNoArray:["091234567","092345678"]。
修正的車機授權碼清單。
範例：更改參數的車機門號清單，則DeviceUIDArray:["DAI123EER","AAI123EER"]。
修正的車號清單。
範例：更改參數的車機門號清單，則CarNoArray:["ABC-123","DEF-456"]。
|
|
DeviceUIDArray |
車機授權碼清單 |
Array |
|
CarNoArray |
車號清單 |
Array
|
|
StartTime |
開始時間 |
時間字串(yyyy/MM/dd HH:00:00) |
查詢時間範圍的開始時間，精確到小時。
(若輸入時間分、秒，會自動代換為0分0秒。)
|
|
EndTime |
結束時間 |
時間字串(yyyy/MM/dd HH:59:59) |
查詢時間範圍的結束時間，精確到小時。
(若輸入時間分、秒，會自動代換為59分59秒。)
|
|
|
輸出結果 |
若API執行成功，輸出結果為一JSON：
{
"data": {
"Result": "success",
"ErrorCode": "",
"Counter": 1,
"EventInfo": [
{
"GsmNo": "0978016283",
"EventId": "1",
"EventSubId": "2",
"EventTime": "2011/05/05 16:46:00",
"EventAddress": "電研所99號",
"EventLon": 123.4657,
"EventLat": 23.12345,
"CarNo": "036-ZY",
"DeviceUID": "123456"
}
]
}
}
|
輸出參數說明：
|
標籤名稱 |
描述 |
資料型態 |
註解 |
|
Counter |
發送資訊總數 |
整數 |
此次API共回應多少筆EventInfo |
|
EventInfo |
事件資訊 |
|
|
|
GsmNo |
發生事件的車機門號 |
字串 |
發生事件的車輛門號 |
|
EventId |
事件代碼 |
字串 |
事件代碼，詳見事件種類代碼表 |
|
EventSubId |
事件子代碼 |
字串 |
|
EventTime |
事件發生時間 |
時間 |
時間，格式 (yyyy/MM/dd HH:mm:ss) |
|
EventAddress |
Html編碼後的事件地址 |
字串 |
Html編碼後的事件地址 |
|
EventLon |
事件發生經度 |
浮點數 |
事件發生經度 |
|
EventLat |
事件發生緯度 |
浮點數 |
事件發生緯度 |
|
CarNo |
發生事件的車輛車牌 |
字串 |
發生事件的車輛車牌 |
|
DeviceUID |
發生事件車輛之授權碼 |
字串 |
發生事件車輛之授權碼 |
| 事件主代碼 |
事件子代碼 |
說明 |
| 1 |
1 |
前向防碰撞預警-正常 |
| 2 |
前向防碰撞預警-檢測到車輛，危險距離 |
| 2 |
0 |
車道偏移預警-正常 |
| 1 |
車道偏移預警-壓左車道線 |
| 2 |
車道偏移預警-壓右車道線 |
| 3 |
0 |
人臉檢測-正常 |
| 1 |
人臉檢測-無駕駛員 |
| 2 |
人臉檢測-駕駛員打電話 |
| 3 |
人臉檢測-吸煙 |
| 4 |
人臉檢測-姿態異常 |
| 5 |
人臉檢測-哈欠 |
| 6 |
人臉檢測-閉眼 |
|
|
錯誤訊息 |
若API執行失敗，結果以XML格式回傳：
{
"data": {
"Result": "fail",
"ErrorCode": "錯誤訊息代碼",
"Counter": 0,
"EventInfo": []
}
}
|
錯誤訊息代碼說明如下：
|
錯誤訊息代碼 |
錯誤說明 |
|
001 |
輸入的授權碼(Key)是不合法的授權碼 |
|
002 |
使用的IP是不合法的IP |
|
003 |
存取時間小於允許間隔時間 |
|
004 |
輸入的客戶證號(Ccid)不正確 |
|
010 |
輸入的參數有缺漏 |
|
011 |
輸入的查詢時間已間隔30天以上 |
|
012 |
查詢結束時間必須大於查詢開始時間 |
|
200 |
系統忙碌或其他原因造成沒有完成服務，請重試 |
|
範例 |
範例1
{
"Ccid":"19683911",
"Key":"179ce128-9b93-4ea9-994c-14bb54d56a91",
"GsmNoArray": ["0928666123","0928123456"],
"StartTime": "2017/05/01 12:11:11",
"EndTime": "2017/05/30 12:11:11"
}
|
回應範例
{
"data": {
"Result": "success",
"ErrorCode": "",
"Counter": 2,
"EventInfo": [
{
"GsmNo": "0978016283",
"EventId": "1",
"EventSubId": "2",
"EventTime": "2017/05/05 16:46:00",
"EventAddress": "電研所99號",
"EventLon": 123.4657,
"EventLat": 23.12345,
"CarNo": "036-ZY",
"DeviceUID": "123456"
},
{
"GsmNo": "0978016283",
"EventId": "1",
"EventSubId": "1",
"EventTime": "2017/05/05 16:46:00",
"EventAddress": "電研所99號",
"EventLon": 123.4657,
"EventLat": 23.12345,
"CarNo": "036-ZY",
"DeviceUID": "123456"
}
]
}
}
|
|