Upload and Analyze Resume Uploads a resume file and triggers asynchronous AI-powered analysis. The endpoint supports multiple file formats and includes built-in duplicate detection via content hash comparison.
Endpoint Authentication This endpoint requires authentication. Include your authentication token in the request headers.
Rate Limiting This endpoint is rate-limited to 5 requests per IP address and globally. Exceeds will result in HTTP 429 (Too Many Requests).
Request Must be multipart/form-data
Body Parameters The resume file to upload and analyze. Supported formats:
PDF (.pdf)
Microsoft Word (.docx, .doc)
Plain text (.txt)
Markdown (.md)
Maximum file size: 10 MBResponse Status code. 200 indicates success.
Response message. Returns “检测到相同简历，已返回历史分析结果” if duplicate is detected.
Response data containing resume upload and analysis information. Resume metadata Unique identifier for the uploaded resume
Original filename of the uploaded resume
Current analysis status. Values: PENDING, PROCESSING, COMPLETED, FAILED
File storage information Storage key used to retrieve the file from RustFS
Direct URL to access the stored file
Resume ID associated with the stored file
Whether the uploaded resume is a duplicate (detected via content hash)
Only present if duplicate is detected and previous analysis exists Overall resume score (0-100)
Content quality score (0-100)
Resume structure score (0-100)
Skill relevance score (0-100)
Expression and clarity score (0-100)
Project experience score (0-100)
AI-generated summary of the resume analysis
List of identified strengths
List of improvement suggestions
Examples curl -X POST https://api.example.com/api/resumes/upload \ -H "Authorization: Bearer YOUR_TOKEN" \ -F "file=@/path/to/resume.pdf"
Response Examples New Resume Upload (Success) { "code" : 200 , "message" : "success" , "data" : { "resume" : { "id" : 12345 , "filename" : "john_doe_resume.pdf" , "analyzeStatus" : "PENDING" }, "storage" : { "fileKey" : "resumes/2026/03/10/abc123.pdf" , "fileUrl" : "https://storage.example.com/resumes/2026/03/10/abc123.pdf" , "resumeId" : 12345 }, "duplicate" : false } }
Duplicate Resume Detected { "code" : 200 , "message" : "检测到相同简历，已返回历史分析结果" , "data" : { "analysis" : { "overallScore" : 85 , "contentScore" : 88 , "structureScore" : 82 , "skillMatchScore" : 87 , "expressionScore" : 84 , "projectScore" : 86 , "summary" : "这是一份优秀的简历，展现了丰富的项目经验和扎实的技术能力。" , "strengths" : [ "丰富的全栈开发经验" , "清晰的项目成果展示" , "技术栈覆盖广泛" ], "suggestions" : [ { "category" : "内容优化" , "description" : "建议增加量化的业务成果数据" } ] }, "storage" : { "fileKey" : "resumes/2026/03/05/xyz789.pdf" , "fileUrl" : "https://storage.example.com/resumes/2026/03/05/xyz789.pdf" , "resumeId" : 12340 }, "duplicate" : true } }
Error Responses Invalid request parameters or unsupported file type
Unable to extract text from the resume file (e.g., scanned PDF)
The uploaded file is empty
2006
RESUME_FILE_TYPE_NOT_SUPPORTED
The file type is not supported
Failed to upload file to storage service
Rate limit exceeded (more than 5 uploads)
Error Response Example { "code" : 2002 , "message" : "无法从文件中提取文本内容，请确保文件不是扫描版PDF" , "data" : null }
Processing Flow
File Validation : The system validates file type, size, and contentDuplicate Detection : Content hash is calculated and checked against existing resumesText Extraction : Resume text is parsed from the uploaded fileStorage : File is stored in RustFS with a unique keyDatabase Persistence : Resume metadata is saved with PENDING statusAsync Analysis : Analysis task is queued to Redis Stream for background processingResponse : Client receives immediate response with resume ID and storage info
Polling for Results : Since analysis is asynchronous, use the Get Resume Detail endpoint to poll for analysis completion. The analyzeStatus field will change from PENDING to COMPLETED when ready.Notes
Analysis typically completes within 10-30 seconds depending on resume complexity
Duplicate detection uses SHA-256 content hashing
If a duplicate is found with existing analysis results, they are returned immediately
Failed analyses can be retried using the Reanalyze Resume endpoint
Reanalyze Resume Manually trigger re-analysis of a previously uploaded resume. Useful for retrying failed analyses or getting updated results.
Endpoint POST /api/resumes/{id}/reanalyze
Rate Limiting This endpoint is rate-limited to 2 requests per IP address and globally per resume.
Path Parameters The unique identifier of the resume to reanalyze
Response Status code. 200 indicates success.
No data returned for this endpoint
Example Request curl -X POST https://api.example.com/api/resumes/12345/reanalyze \ -H "Authorization: Bearer YOUR_TOKEN"
Success Response { "code" : 200 , "message" : "success" , "data" : null }
Error Responses Resume with the specified ID does not exist
Unable to retrieve or parse resume text content
Rate limit exceeded (more than 2 reanalyze requests)
Notes
The resume status is reset to PENDING when reanalysis is triggered
Any previous analysis errors are cleared
If resume text is not cached, the system will re-parse the original file from storage
Poll the Get Resume Detail endpoint to check analysis progress
