公司入驻申请 API
公司入驻申请模块提供公司申请加入系统的完整流程管理。
基础信息
- 用户端路径:
/api/v1/company-applications - 管理端路径:
/api/v1/admin/company-applications - 认证要求: 需要登录（管理功能需要管理员权限）
- 认证方式: Bearer Token (JWT)
用户端接口
1. 创建入驻申请
端点: POST /api/v1/company-applications
请求体:
json
{
"company_name": "科技有限公司",
"contact_person": "张经理",
"contact_phone": "13800138000",
"contact_email": "zhang@example.com",
"business_license": "91110000XXXXXXXXXX",
"description": "我们是一家科技公司",
"company_id": 1
}cURL 示例:
bash
curl -X POST http://localhost:8080/api/v1/company-applications \
-H "Authorization: Bearer YOUR_JWT_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"company_name": "科技有限公司",
"contact_person": "张经理",
"contact_phone": "13800138000"
}'2. 查看我的申请
端点: GET /api/v1/company-applications/my
cURL 示例:
bash
curl -X GET http://localhost:8080/api/v1/company-applications/my \
-H "Authorization: Bearer YOUR_JWT_TOKEN"3. 解析加入二维码
端点: POST /api/v1/companies/join-qr/resolve
请求体:
json
{
"qr_code": "ENCODED_QR_CODE_STRING"
}cURL 示例:
bash
curl -X POST http://localhost:8080/api/v1/companies/join-qr/resolve \
-H "Authorization: Bearer YOUR_JWT_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"qr_code": "ENCODED_QR_CODE_STRING"
}'管理端接口
1. 生成加入二维码
端点: POST /api/v1/admin/companies/:id/join-qr
cURL 示例:
bash
curl -X POST http://localhost:8080/api/v1/admin/companies/1/join-qr \
-H "Authorization: Bearer YOUR_JWT_TOKEN" \
-H "Content-Type: application/json"2. 获取所有申请列表
端点: GET /api/v1/admin/company-applications
查询参数:
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| page | integer | 否 | 页码 |
| page_size | integer | 否 | 每页数量 |
| status | string | 否 | 状态筛选：pending/approved/rejected |
cURL 示例:
bash
curl -X GET "http://localhost:8080/api/v1/admin/company-applications?page=1&page_size=10&status=pending" \
-H "Authorization: Bearer YOUR_JWT_TOKEN"3. 查看申请详情
端点: GET /api/v1/admin/company-applications/:id
cURL 示例:
bash
curl -X GET http://localhost:8080/api/v1/admin/company-applications/1 \
-H "Authorization: Bearer YOUR_JWT_TOKEN"4. 审批申请
端点: PATCH /api/v1/admin/company-applications/:id/decision
请求体:
json
{
"decision": "approved",
"notes": "审批通过"
}参数说明:
decision: approved（通过）或 rejected（拒绝）notes: 审批备注（可选）
cURL 示例（通过申请）:
bash
curl -X PATCH http://localhost:8080/api/v1/admin/company-applications/1/decision \
-H "Authorization: Bearer YOUR_JWT_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"decision": "approved",
"notes": "审批通过"
}'cURL 示例（拒绝申请）:
bash
curl -X PATCH http://localhost:8080/api/v1/admin/company-applications/1/decision \
-H "Authorization: Bearer YOUR_JWT_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"decision": "rejected",
"notes": "资质不符合要求"
}'申请状态
pending: 待审批approved: 已通过rejected: 已拒绝