银行账户管理 API
银行账户管理模块提供员工银行账户信息的管理功能。
基础信息
- 基础路径:
/api/v1/admin/bank-accounts - 认证要求: 需要管理员权限
- 认证方式: Bearer Token (JWT)
API 端点
1. 创建银行账户
端点: POST /api/v1/admin/bank-accounts
请求体:
json
{
"employee_id": 1,
"bank_name": "中国工商银行",
"account_number": "6222021234567890",
"account_holder": "张三",
"branch": "北京分行",
"is_default": true
}cURL 示例:
bash
curl -X POST http://localhost:8080/api/v1/admin/bank-accounts \
-H "Authorization: Bearer YOUR_JWT_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"employee_id": 1,
"bank_name": "中国工商银行",
"account_number": "6222021234567890",
"account_holder": "张三"
}'2. 更新银行账户
端点: PUT /api/v1/admin/bank-accounts/:id
cURL 示例:
bash
curl -X PUT http://localhost:8080/api/v1/admin/bank-accounts/1 \
-H "Authorization: Bearer YOUR_JWT_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"branch": "上海分行"
}'3. 删除银行账户
端点: DELETE /api/v1/admin/bank-accounts/:id
cURL 示例:
bash
curl -X DELETE http://localhost:8080/api/v1/admin/bank-accounts/1 \
-H "Authorization: Bearer YOUR_JWT_TOKEN"4. 获取员工的所有银行账户
端点: GET /api/v1/admin/employee-bank-accounts/:employeeId
cURL 示例:
bash
curl -X GET http://localhost:8080/api/v1/admin/employee-bank-accounts/1 \
-H "Authorization: Bearer YOUR_JWT_TOKEN"5. 设置默认银行账户
端点: POST /api/v1/admin/employee-bank-accounts/:employeeId/set-default
请求体:
json
{
"bank_account_id": 1
}cURL 示例:
bash
curl -X POST http://localhost:8080/api/v1/admin/employee-bank-accounts/1/set-default \
-H "Authorization: Bearer YOUR_JWT_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"bank_account_id": 1
}'