云计算服务
服务器租用
DDOS 防护
虚拟主机
域名服务
基础设施
关于我们
openQcTaskReport/addTaskReports API 文档
描述
openQcTaskReport/addTaskReports API 是用于向数据库添加质量控制任务报告的接口，该API允许用户将一个或多个质量控制任务的报告信息提交到数据库中，以便于后续的数据分析和报告生成。
请求URL
POST /api/openQcTaskReport/addTaskReports
请求方式
方法：POST
请求头
ContentType: application/json
Authorization: Bearer {access_token}
请求参数（Body）
参数名 类型 是否必须 描述 taskReports Array 是 包含一个或多个任务报告对象的数组taskReports 对象属性
参数名 类型 是否必须 描述 taskId Number 是 任务的唯一标识符 userId Number 是 执行任务的用户的唯一标识符 reportDate Date 是 报告生成的日期 status String 是 任务的状态（已完成、进行中、已取消等） comments String 否 对任务结果的评论或说明 attachments Array 否 与任务相关的附件列表attachments 对象属性
参数名 类型 是否必须 描述 fileName String 是 附件的文件名 fileSize Number 是 附件的文件大小（以字节为单位） fileType String 是 附件的文件类型（pdf、jpg、png等） url String 是 附件的下载链接响应参数
参数名 类型 描述 status Number API请求的状态码，200表示成功，其他值表示出现错误 message String API请求的结果消息 data Array 包含一个或多个任务报告对象的数组，这些对象与请求参数中的taskReports对象具有相同的属性示例代码
以下是一个使用JavaScript的fetch函数调用openQcTaskReport/addTaskReports API的示例代码：
const taskReports = [
{
taskId: 1,
userId: 1001,
reportDate: new Date(),
status: "completed",
comments: "Task completed successfully",
attachments: [
{
fileName: "report.pdf",
fileSize: 1024,
fileType: "application/pdf",
url: "https://example.com/report.pdf"
}
]
}
];
const requestOptions = {
method: "POST",
headers: {
"ContentType": "application/json",
"Authorization": "Bearer {access_token}"
},
body: JSON.stringify({ taskReports })
};
fetch("/api/openQcTaskReport/addTaskReports", requestOptions)
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error("Error:", error));相关问答FAQs
Q1: 如果请求中的任务报告数组为空，API会如何处理？
A1: 如果请求中的任务报告数组为空，API将返回一个状态码为200的成功响应，但响应体中的"data"字段将为空数组，这是因为API假定用户可能想要创建一个空的任务报告记录。
Q2: 如果某个任务报告对象缺少必要的属性，API会如何处理？
A2: 如果某个任务报告对象缺少必要的属性，API将返回一个状态码为400的响应，并在响应体的"message"字段中指出缺少的属性，这是因为所有必要的属性都是创建有效任务报告所必需的。
.png)
.png)
