Appearance
获取巡检记录列表 API
| Path | Method | Created At |
|---|---|---|
| /api/contracts/inspections/paginate | POST | 2025-11-29 00:39:11 |
Request
| Key | Rule | Description |
|---|---|---|
| page | integer,min:1,max:100 | 页码必须为正整数 |
| page_size | integer,min:5,max:1000 | 每页数量必须为正整数 |
| contract_id | string,size:24 | 合同不存在 |
| is_archived | App\Rules\BoolRule | 是否归档字段错误 |
| conditions | array | 查询条件必须是数组 |
| sorts | array | 排序条件必须是数组 |
Response
| Key | Type | Example | Comment |
|---|---|---|---|
| id | string | 43ab23 | 编号 |
| contractId | string | 23d82 | 合同ID |
| contractName | string | 一期合同 | 合同名称 |
| content | string | 巡检内容描述 | 内容 |
| startDate | string | 2024-01-01 00:00:00 | 开始日期 |
| endDate | string | 2024-12-31 23:59:59 | 结束日期 |
| frequency | string | Month | 巡检频率 |
| status | string | Completed | 状态 |
| salesId | int | 1 | 销售ID |
| salesName | string | 张三 | 销售名称 |
| inspectorId | int | 2 | 巡检人员ID |
| inspectorName | string | 李四 | 巡检人员名称 |
| currentInspectionTime | string | 2024-06-01 10:00:00 | 本次巡检时间 |
| nextInspectionTime | string | 2024-07-01 10:00:00 | 下次巡检时间 |
| inspectionCount | int | 5 | 已巡检次数 |
| inspectionIssues | string | 发现交换机端口故障 | 巡检问题 |
| customerContact | string | 张三 | 客户联系人 |
| customerPhone | string | 13800138000 | 客户联系电话 |
| workHours | float | 8.5 | 工时 |
| isCompleted | bool | true | 是否完成 |
| pendingIssues | string | 需要更换设备 | 待处理问题 |
| attachments | array | [] | 附件 |
| createdBy | int | 1 | 创建人ID |
| createdByName | string | 王五 | 创建人名称 |
| updatedBy | int | 1 | 更新人ID |
| updatedByName | string | 赵六 | 更新人名称 |
| createdAt | string | 2024-01-01 00:00:00 | 创建时间 |
| updatedAt | string | 2024-01-01 00:00:00 | 更新时间 |
TypeScript Result Example:
TypeScript
interface Result {
/** 编号 */
id: string;
/** 合同ID */
contractId: string;
/** 合同名称 */
contractName: string;
/** 内容 */
content: string;
/** 开始日期 */
startDate: string;
/** 结束日期 */
endDate: string;
/** 巡检频率 */
frequency: string;
/** 状态 */
status: string;
/** 销售ID */
salesId: number;
/** 销售名称 */
salesName: string;
/** 巡检人员ID */
inspectorId: number;
/** 巡检人员名称 */
inspectorName: string;
/** 本次巡检时间 */
currentInspectionTime: string;
/** 下次巡检时间 */
nextInspectionTime: string;
/** 已巡检次数 */
inspectionCount: number;
/** 巡检问题 */
inspectionIssues: string;
/** 客户联系人 */
customerContact: string;
/** 客户联系电话 */
customerPhone: string;
/** 工时 */
workHours: any;
/** 是否完成 */
isCompleted: any;
/** 待处理问题 */
pendingIssues: string;
/** 附件 */
attachments: any;
/** 创建人ID */
createdBy: number;
/** 创建人名称 */
createdByName: string;
/** 更新人ID */
updatedBy: number;
/** 更新人名称 */
updatedByName: string;
/** 创建时间 */
createdAt: string;
/** 更新时间 */
updatedAt: string;
}