适合客户先获取某个本校当前已缓存的课程号，再按课程号查询等价关系。默认不传本校名称时，使用当前任务配置的本校；不传学期时，使用该本校最新已采集学期。

请求

GET /api/public/home-courses?homeSchoolName=Boston%20University&page=1&pageSize=50
GET /api/public/home-courses?targetId=bu__202607&pageLimit=100

参数

• homeSchoolName：本校名称，非必填；不传则默认当前任务配置的本校
• termCode / termLabel：可选；用于指定学期；都不传则返回该本校最新已采集学期
• page：页码，默认 1
• pageSize / pageLimit：每页数量；两者都支持，pageLimit 作为兼容别名
• targetId / homeUniq：高级参数，用于精确指定学校或历史 target
• search / q：可选，按部门、课号或课程名模糊过滤；q 是兼容别名

返回示例

{
  "ok": true,
  "available": true,
  "dbPath": ".../transferology_unified.db",
  "targetId": "bu__202607",
  "target": {},
  "homeSchoolName": "Boston University",
  "homeUniq": "BU",
  "termLabel": "Summer 2026",
  "termCode": "202607",
  "page": 1,
  "pageSize": 50,
  "pageLimit": 50,
  "totalPages": 8,
  "total": 390,
  "rows": [
    {
      "courseKey": "CAS BI:CAS BI211",
      "department": "CAS BI",
      "departmentTitle": "Biology",
      "courseCode": "CAS BI211",
      "courseTitle": "Human Physiology",
      "hours": "4",
      "completed": true,
      "resultCount": 12,
      "lastError": ""
    }
  ],
  "message": ""
}

等待请求...

适合查未落库或需要立即验证的课程。该模式会登录 Transferology 实时解析，提交后返回 jobId。

请求

POST /api/public/equivs/live
Content-Type: application/json

{
  "homeSchoolName": "University of Wisconsin-Madison",
  "termMode": "latest",
  "courseCodes": ["MATH96", "MATH221"],
  "allowlistFilter": true
}

参数

• homeSchoolName：本校名称，通常填写；如已传 homeUniq / schoolId / targetId，可省略；未指定时后端自动解析 UNIQ / schoolId
• termMode：latest 或 manual；不传默认 latest
• homeUniq / schoolId / targetId：高级定位参数，提供后可跳过名称解析，适合精确指定历史 target
• termLabel / termCode：可选，manual 时至少传一个；例如 Summer 2026 或 202607；缺失时回退到 latest
• courseCodes：可传数组，也可传逗号分隔字符串
• allowlistFilter：是否按白名单外校过滤，默认 true
• timeoutSeconds：单个 Transferology 请求超时时间，默认 7200 秒，最小 60 秒

成功返回

{
  "ok": true,
  "jobId": "live_abc123",
  "status": "queued",
  "homeSchoolName": "University of Wisconsin-Madison",
  "termMode": "latest",
  "termLabel": "",
  "termCode": "202604",
  "courseCodes": ["MATH96", "MATH221"],
  "totalCourses": 2,
  "finishedCourses": 0,
  "message": "Live query has been queued"
}

等待请求...

实时查询启动后，使用 jobId 轮询任务进度和结果。

请求

GET /api/public/equivs/live/<jobId>?page=1&pageSize=50

返回

{
  "ok": true,
  "jobId": "live_xxx",
  "status": "queued | running | completed | failed | not_found",
  "createdAt": "2026-09-18T10:30:00",
  "updatedAt": "2026-09-18T10:30:00",
  "homeSchoolName": "University of Wisconsin-Madison",
  "homeUniq": "WISC",
  "schoolId": "12345",
  "termMode": "latest",
  "termLabel": "",
  "termCode": "202604",
  "allowlistFilter": true,
  "targetId": "wisc__202604",
  "target": {},
  "courseCodes": ["MATH96", "MATH221"],
  "courseCode": "MATH96,MATH221",
  "totalCourses": 2,
  "finishedCourses": 0,
  "page": 1,
  "pageSize": 50,
  "totalPages": 0,
  "total": 0,
  "rows": [],
  "errors": [],
  "diagnostics": {},
  "message": "Live query has been queued"
}

not_found 时接口返回 HTTP 404；其他状态通常返回 HTTP 200。

等待请求...