按端点分类的错误代码

​

触发数据采集

POST /datasets/v3/trigger

与 "触发数据采集" 端点相关的错误代码

http_status_code	message
400	{validation_errors: [ERRORS]}
	dataset missing （数据集缺失）
	附件无效
	此数据集不允许使用 API
	此数据集尚未准备好
	无可触发的数据
	输入数据至少应为 LIMIT 条
404	dataset does not exist （数据集不存在）
429	您在此数据集中运行的任务过多。请等待一些任务完成，或考虑将多个输入合并为单个请求。当前运行任务数：RUNNING_JOBS>=JOBS_LIMIT
500	内部服务器错误

​

下载快照

GET /datasets/v3/snapshot/:snapshot_id

与 "下载快照" 端点相关的错误代码

http_status_code	message
202	{status: "STATUS", message: "快照尚未准备好，请 10 秒后重试"}
	{status: "building", message: "快照正在生成，请 10 秒后重试"}
400	{validation_errors: [ERRORS]}
	快照已过期
	快照为空
404	快照不存在
500	内部服务器错误

​

计算交付的分片数量

GET /datasets/v3/snapshot/:snapshot_id/parts

与 "计算交付的分片数量" 端点相关的错误代码

http_status_code	message
400	{validation_errors: [ERRORS]}
	快照尚未准备好
404	快照不存在
500	内部服务器错误

​

获取已触发快照的输入文件

GET /datasets/v3/snapshot/:snapshot_id/input

与 "获取已触发快照的输入文件" 端点相关的错误代码

http_status_code	message
400	快照输入文件不存在
404	快照不存在
500	内部服务器错误

​

取消数据采集

POST /datasets/v3/snapshot/:snapshot_id/cancel

与 "取消数据采集" 端点相关的错误代码

http_status_code	message
400	快照未在运行
404	快照不存在
500	内部服务器错误

​

监控进度

GET /datasets/v3/progress/:snapshot_id

与 "监控进度" 端点相关的错误代码

http_status_code	message
404	快照不存在
500	内部服务器错误
200	{status: "failed", error_message: "ERROR_MESSAGE"}
	发生错误，我们的团队正在调查
	账户已被暂停
	账户新注册，请在账户设置中激活（URL）
	在数据发现中未找到数据
	快照为空
	交付快照失败
	下载响应失败
	触发采集器失败
	内部服务器错误
	输入验证失败：DETAILS

​

监控数据交付

GET /datasets/v3/delivery/:delivery_id

与 "监控数据交付" 端点相关的错误代码

http_status_code	message
404	数据交付不存在
500	内部服务器错误

​

将收集的数据传输到存储

POST /datasets/v3/deliver/:snapshot_id

与 "将收集的数据传输到存储" 端点相关的错误代码

http_status_code	message
400	{validation_errors: [ERRORS]}
	快照尚未准备好
	快照已过期
	缺少交付选项
	快照为空
	快照过大，无法以单个文件交付
	批处理大小至少应为 MIN_BATCH_SIZE
404	快照不存在
500	交付快照失败
	内部服务器错误

​

获取快照列表

GET /datasets/v3/snapshots

与 "获取快照列表" 端点相关的错误代码

http_status_code	message
400	{validation_errors: [ERRORS]}
500	内部服务器错误