合同管理 API
合同管理模块提供员工合同的创建、查询、更新和删除功能。
基础信息
- 基础路径:
/api/v1/admin/contracts - 认证要求: 需要管理员权限
- 认证方式: Bearer Token (JWT)
API 端点
1. 创建合同
端点: POST /api/v1/admin/contracts
请求体:
json
{
"employee_id": 1,
"contract_type": "labor",
"start_date": "2024-01-01",
"end_date": "2025-12-31",
"salary": 10000.00,
"department": "技术部",
"position": "高级工程师",
"notes": "合同备注"
}cURL 示例:
bash
curl -X POST http://localhost:8080/api/v1/admin/contracts \
-H "Authorization: Bearer YOUR_JWT_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"employee_id": 1,
"contract_type": "labor",
"start_date": "2024-01-01",
"end_date": "2025-12-31",
"salary": 10000.00
}'2. 获取合同详情
端点: GET /api/v1/admin/contracts/:id
cURL 示例:
bash
curl -X GET http://localhost:8080/api/v1/admin/contracts/1 \
-H "Authorization: Bearer YOUR_JWT_TOKEN"3. 更新合同
端点: PUT /api/v1/admin/contracts/:id
cURL 示例:
bash
curl -X PUT http://localhost:8080/api/v1/admin/contracts/1 \
-H "Authorization: Bearer YOUR_JWT_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"end_date": "2026-12-31",
"salary": 12000.00
}'4. 删除合同
端点: DELETE /api/v1/admin/contracts/:id
cURL 示例:
bash
curl -X DELETE http://localhost:8080/api/v1/admin/contracts/1 \
-H "Authorization: Bearer YOUR_JWT_TOKEN"5. 获取员工的所有合同
端点: GET /api/v1/admin/employee-contracts/:employeeId
cURL 示例:
bash
curl -X GET http://localhost:8080/api/v1/admin/employee-contracts/1 \
-H "Authorization: Bearer YOUR_JWT_TOKEN"