You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
8.4 KiB
8.4 KiB
联调路径校正映射表（基于 job.youthome.com.cn OpenAPI 实测）
生成日期：2026-09-28 | 数据源：
scripts/openapi.json（182 条真实路径 / 220 path-methods） 审计范围：api.ts 内全部request()调用（89 个函数） 结论：ALIGNED（已对齐）= 6，WRONG→REAL（路径错但有真实等价）= 14，PHANTOM（幽灵域，后端无契约）= 69
一、已对齐（无需改路径）
| 函数 | 真实路径 | 原标记 |
|---|---|---|
createJobReview |
POST /jobs/{jobId}/reviews |
已校正 |
fetchCompareData |
/jobs/compare |
已校正 |
fetchEmployeeReviews |
GET /jobs/{jobId}/reviews |
已校正 |
fetchJobDetail |
GET /jobs/{jobId} |
已校正 |
fetchOfferCompareData |
GET /offers/compare |
【待确认】 |
fetchUserProfile |
GET /profile/me |
已校正 |
二、路径错但有真实等价端点（需改路径）
| 函数 | 当前(错) | 应改为(真实) | 说明 |
|---|---|---|---|
fetchCandidateDetail |
/enterprise/candidates/${candidateId} |
/company/candidates/{applicationId} |
前端猜 /enterprise/candidates，真路径在 /company 域 |
fetchConversation |
/chat/conversations/${id} |
GET /conversations/{id} |
前端猜 /chat/conversations，真路径 /conversations/{id} |
fetchConversations |
/messages/conversations |
GET /conversations |
前端猜 /messages/conversations，真 /conversations |
fetchInterviewScore |
/enterprise/interviews/${interviewId}/score |
GET /interviews/{interviewId}/score |
前端猜 /enterprise/interviews，真路径在 /interviews 域 |
fetchInterviewScoreDraft |
/enterprise/interviews/${interviewId}/score/draft |
PUT /interviews/{interviewId}/score |
真路径无 /draft 子路径，保存草稿用 PUT /interviews/{id}/score |
fetchInterviews |
/messages/interviews |
GET /interviews/me |
前端猜 /messages/interviews，真 /interviews/me(我的面试列表) |
fetchJobPreference |
/profile/me/job-preference |
GET/PUT /profile/me/preferences |
前端猜 /profile/me/job-preference，真路径 /profile/me/preferences |
fetchJobProgress |
/tools/job-progress |
GET /profile/me/career-progress |
前端猜 /tools/job-progress，真 /profile/me/career-progress(统一求职进度聚合) |
fetchMatchResult |
/messages/match-result |
GET /applications/{id}/match 或 /jobs/{jobId}/match |
前端猜 /messages/match-result，真为投递/岗位匹配诊断 |
fetchNotifications |
/messages/notifications |
GET /notifications |
前端猜 /messages/notifications，真 /notifications |
fetchRankData |
/jobs/rank |
GET /jobs/{jobId}/competition-ranking |
前端猜 /jobs/rank，真为按岗位竞争力排名，语义不同(需 jobId) |
fetchResume |
/resume |
GET /profile/me/resume |
前端猜 /resume，真 /profile/me/resume(下载简历) |
saveJobPreference |
/profile/me/job-preference |
PUT /profile/me/preferences |
同上 |
saveResumeBasicInfo |
/resume/basic-info |
POST /profile/me/resume (multipart) |
前端猜 /resume/basic-info，真为上传简历文件(multipart)，结构化字段在 PUT /profile/me |
三、幽灵域（后端 OpenAPI 无契约，必须退回 mock-only）
| 函数 | 当前(幽灵)路径 | 说明 |
|---|---|---|
deleteSalaryRecord |
/salary/records/${id} |
无 /salary 域，后端未提供 |
fetchAIInterviewData |
/interview/config |
未命中 OpenAPI |
fetchAITools |
/growth/ai-tools |
未命中 OpenAPI |
fetchAbilityAssessment |
/growth/ability |
未命中 OpenAPI |
fetchAboutInfo |
/settings/about |
未命中 OpenAPI |
fetchAccountCancel |
/settings/account-cancel |
未命中 OpenAPI |
fetchAccountSecurity |
/settings/account-security |
未命中 OpenAPI |
fetchAppealForm |
/evaluation/appeal |
未命中 OpenAPI |
fetchArticles |
/growth/articles |
未命中 OpenAPI |
fetchAuditReport |
/operation/audit-report |
未命中 OpenAPI |
fetchBadges |
/user/badges |
未命中 OpenAPI |
fetchDimensionScores |
/user/dimension-scores |
未命中 OpenAPI |
fetchDndSetting |
/settings/privacy/dnd |
未命中 OpenAPI |
fetchEnterpriseCertification |
/enterprise/certification |
未命中 OpenAPI |
fetchEnterpriseCommunication |
/enterprise/communication |
未命中 OpenAPI |
fetchEnterpriseEntry |
/user/enterprise-entry |
未命中 OpenAPI |
fetchEnterpriseOverview |
/enterprise/overview |
未命中 OpenAPI |
fetchGameLevels |
/game/levels |
未命中 OpenAPI |
fetchGameProgress |
/game/progress |
未命中 OpenAPI |
fetchHREvaluation |
/evaluation/hr |
未命中 OpenAPI |
fetchHollandAssessment |
/growth/holland |
未命中 OpenAPI |
fetchHollandIntro |
/growth/holland-intro |
未命中 OpenAPI |
fetchIdentityOptions |
/tools/identity-options |
未命中 OpenAPI |
fetchJobEvaluationEmptyState |
/enterprise/job-evaluation-empty |
未命中 OpenAPI |
fetchJobEvaluationManagement |
/enterprise/job-evaluations |
未命中 OpenAPI |
fetchJobManagement |
/enterprise/job-management |
未命中 OpenAPI |
fetchJobOverallScore |
/jobs/${id}/score |
无 /jobs/{id}/score，综合分见 /jobs/{id}/competition-ranking 或 /profile/me/candidate-scoring |
fetchJobPublishForm |
/enterprise/jobs/publish-form |
未命中 OpenAPI |
fetchKeywordBlock |
/settings/privacy/keywords |
未命中 OpenAPI |
fetchLegalBrand |
/legal/brand |
未命中 OpenAPI |
fetchLegalConversation |
/legal/conversations/default |
未命中 OpenAPI |
fetchLegalDocument |
/settings/legal-document/${id} |
无 /legal 域，后端未提供 |
fetchLegalFAQs |
/legal/faqs |
未命中 OpenAPI |
fetchLegalMembership |
/legal/membership |
未命中 OpenAPI |
fetchLegalOrders |
/legal/orders |
未命中 OpenAPI |
fetchLegalPlans |
/legal/plans |
未命中 OpenAPI |
fetchLegalServiceRequests |
/legal/service-requests |
未命中 OpenAPI |
fetchLegalServices |
/legal/services |
未命中 OpenAPI |
fetchLegalTemplates |
/legal/templates |
未命中 OpenAPI |
fetchMenuItems |
/user/menus |
未命中 OpenAPI |
fetchNotificationSettings |
/settings/notification |
未命中 OpenAPI |
fetchOperationRules |
/operation/rules |
未命中 OpenAPI |
fetchOverallScore |
/user/overall-score |
未命中 OpenAPI |
fetchPendingOfferCount |
/offers/pending/count |
无 /offers/pending/count，可用 /offers/statistics 替代(需确认) |
fetchPersonalDataExport |
/settings/personal-data-export |
未命中 OpenAPI |
fetchPrivacyCenter |
/settings/privacy-center |
未命中 OpenAPI |
fetchPrivacyDetailSetting |
/settings/privacy/${id} |
无 /settings 域，后端未提供 |
fetchPrivacySettings |
/settings/privacy |
未命中 OpenAPI |
fetchQualifications |
/settings/qualifications |
未命中 OpenAPI |
fetchResumeExportSettings |
/resume/export-settings |
无 /resume/export-settings，导出设置本地维护 |
fetchResumeSavedAt |
/resume/saved-at |
无 /resume/saved-at，简历保存时间可由 /profile/me/resume-versions 派生 |
fetchSalaryBrackets |
/tools/salary-brackets |
未命中 OpenAPI |
fetchSalaryData |
/jobs/${id}/salary |
无 /jobs/{id}/salary，后端未提供薪资明细端点 |
fetchSalaryRecords |
/salary/records |
未命中 OpenAPI |
fetchSalaryToolLinks |
/tools/salary-related |
未命中 OpenAPI |
fetchSkillCloud |
/tools/skill-cloud |
未命中 OpenAPI |
fetchSkillLearningPath |
/tools/skill-learning-path |
未命中 OpenAPI |
fetchTalentRecommendation |
/enterprise/talent-recommendation |
未命中 OpenAPI |
fetchUserStats |
/user/stats |
未命中 OpenAPI |
fetchWeightSettings |
/jobs/weight-settings |
无 /jobs/weight-settings，权重见 /profile/me/review-weights、/review-weight-templates |
saveResumeEducation |
/resume/education |
无 /resume/education，简历整体由 /profile/me/resume + resume-versions 管理 |
saveResumeExperience |
/resume/experience |
同上 |
saveResumeExportSettings |
/resume/export-settings |
未命中 OpenAPI |
saveResumeProjects |
/resume/projects |
同上 |
saveResumeSelfEvaluation |
/resume/self-evaluation |
同上 |
saveResumeSkills |
/resume/skills |
同上 |
saveResumeSnapshot |
/resume/save |
同上 |
saveSalaryRecord |
/salary/records |
无 /salary/records |
saveWeightSettings |
/weight-settings |
无 /weight-settings |