获取上传的校验文件的列表
调试
您可以在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"
}
]
}错误码
访问错误中心查看更多错误码。
变更历史
更多信息，参考变更详情。