擷取上傳的校正檔案的列表
調試
您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。
調試
授權資訊
請求文法
GET HTTP/1.1請求參數
|
名稱 |
類型 |
必填 |
描述 |
樣本值 |
| StartTime |
string |
是 |
開始時間(RFC 3339 的 UTC 時間) |
2025-12-19T08:30:00Z |
| EndTime |
string |
是 |
結束時間(RFC 3339 的 UTC 時間) |
2025-12-19T20:30:00Z |
| FileKeyword |
string |
否 |
檔案名稱關鍵詞 |
keyword |
| Page |
integer |
否 |
頁碼 |
1 |
| PageSize |
integer |
否 |
每頁條數 |
10 |
返回參數
|
名稱 |
類型 |
描述 |
樣本值 |
|
object |
響應描述 |
||
| RequestId |
string |
請求 ID |
xxx |
| HasNext |
boolean |
是否有下一頁資料 |
true |
| Page |
integer |
頁碼 |
1 |
| PageSize |
integer |
每頁條數 |
10 |
| TotalSize |
integer |
總條數 |
100 |
| TotalPages |
integer |
總頁數 |
10 |
| Files |
array<object> |
檔案清單 |
|
|
object |
|||
| FileName |
string |
檔案名稱 |
test.csv |
| UploadTime |
string |
檔案提交時間 |
2000-01-01T00:00:00Z |
| Status |
string |
任務狀態 |
completed |
| Percentage |
string |
任務執行進度 |
100% |
| CompleteTime |
string |
任務完成時間 |
2000-01-01T00:00:00Z |
| TotalNum |
string |
任務需要校正的地址數量 |
10 |
| ProcessedNum |
string |
任務已經校正完成的地址數量 |
10 |
| ValidNum |
string |
校正結果為 Valid 的地址數量 |
5 |
| InvalidNum |
string |
校正結果為 Invalid 的地址數量 |
4 |
| CatchAllNum |
string |
校正結果為的 CatchAll 地址數量 |
1 |
| DoNotMailNum |
string |
校正結果為 DoNotMail 的地址數量 |
0 |
| UnknownNum |
string |
校正結果為 Unknown 的地址數量 |
0 |
| IsDownloadable |
boolean |
結果是否可以下載 |
true |
| FileId |
string |
檔案 ID |
xxx |
樣本
正常返回樣本
JSON格式
{
"RequestId": "xxx",
"HasNext": true,
"Page": 1,
"PageSize": 10,
"TotalSize": 100,
"TotalPages": 10,
"Files": [
{
"FileName": "test.csv",
"UploadTime": "2000-01-01T00:00:00Z",
"Status": "completed",
"Percentage": "100%",
"CompleteTime": "2000-01-01T00:00:00Z",
"TotalNum": "10",
"ProcessedNum": "10",
"ValidNum": "5",
"InvalidNum": "4",
"CatchAllNum": "1",
"DoNotMailNum": "0",
"UnknownNum": "0",
"IsDownloadable": true,
"FileId": "xxx"
}
]
}錯誤碼
訪問錯誤中心查看更多錯誤碼。
變更歷史
更多資訊，參考變更詳情。