API 参考

curl -X POST https://api2.bysjob.com/api/open/v1/resumes/parse \
  -H "Authorization: Bearer hecn_live_xxx" \
  -H "Idempotency-Key: parse-resume-001" \
  -H "Content-Type: application/json" \
  -d '{
    "fileDataUrl": "data:application/pdf;base64,JVBERi0xLjQK...",
    "fileName": "张三_前端工程师.pdf",
    "pages": 3
  }'

{
  "ok": true,
  "request_id": "8f3c...e21",
  "data": {
    "text": "张三 | 前端工程师\n联系方式：...\n教育背景：...",
    "pages": 3
  },
  "usage": { "pages": 3, "provider": "textin", "model": "xparse-document-parse" },
  "billing": {
    "billed_point_cents": 15,
    "billed_points": 0.15,
    "balance_point_cents": 9985,
    "resource_point_cents": 0
  }
}

curl -X POST https://api2.bysjob.com/api/open/v1/matches/resume-jd \
  -H "Authorization: Bearer hecn_live_xxx" \
  -H "Idempotency-Key: match-001" \
  -H "Content-Type: application/json" \
  -d '{
    "resume_text": "张三，5 年前端经验，精通 React/TypeScript...",
    "jd_text": "招聘高级前端工程师，要求熟悉 React、TypeScript、Webpack..."
  }'

{
  "ok": true,
  "request_id": "a1b2...c3d4",
  "data": {
    "score": 78,
    "strengths": ["React 5 年实战", "TypeScript 类型体系熟悉"],
    "gaps": ["缺少 Node.js 后端经验"],
    "actions": ["建议补充 1-2 个全栈项目案例"]
  },
  "usage": { "prompt_tokens": 1820, "completion_tokens": 320, "total_tokens": 2140 },
  "billing": {
    "billed_point_cents": 100,
    "billed_points": 1,
    "balance_point_cents": 9885,
    "resource_point_cents": 0
  }
}

curl -X POST https://api2.bysjob.com/api/open/v1/jds/optimize \
  -H "Authorization: Bearer hecn_live_xxx" \
  -H "Idempotency-Key: jd-opt-001" \
  -H "Content-Type: application/json" \
  -d '{
    "job_title": "高级前端工程师",
    "requirements": "React/TypeScript/性能优化/跨团队协作",
    "location": "上海",
    "experience": "3-5 年"
  }'

{
  "ok": true,
  "request_id": "e5f6...7890",
  "data": {
    "content": "## 高级前端工程师（上海）\n\n### 岗位职责\n1. ..."
  },
  "usage": { "prompt_tokens": 960, "completion_tokens": 740, "total_tokens": 1700 },
  "billing": {
    "billed_point_cents": 100,
    "billed_points": 1,
    "balance_point_cents": 9785,
    "resource_point_cents": 0
  }
}

curl -X POST https://api2.bysjob.com/api/open/v1/batches/screen \
  -H "Authorization: Bearer hecn_live_xxx" \
  -H "Idempotency-Key: batch-001" \
  -H "Content-Type: application/json" \
  -d '{
    "jd_text": "招聘高级前端工程师，要求 React/TypeScript...",
    "label": "前端组-0625",
    "resumes": [
      { "label": "张三", "text": "5 年前端，精通 React..." },
      { "label": "李四", "text": "3 年前端，Vue 转 React..." }
    ]
  }'

{
  "ok": true,
  "request_id": "b7c8...d9e0",
  "data": { "batch_id": "f1a2...3b4c", "status": "running", "total": 2 },
  "billing": { "billed_point_cents": 0, "billed_points": 0, "balance_point_cents": 0, "resource_point_cents": 0 },
  "estimated_point_cents": 200,
  "billing_note": "费用按候选人数量 × 1 积分异步结算，首响应不计费。"
}

curl -X GET https://api2.bysjob.com/api/open/v1/batches/f1a2...3b4c \
  -H "Authorization: Bearer hecn_live_xxx"

{
  "ok": true,
  "data": {
    "batch_id": "f1a2...3b4c",
    "status": "done",
    "total": 2,
    "completed": 2,
    "label": "前端组-0625",
    "created_at": "2026-06-25T10:00:00.000Z",
    "items": [
      { "candidate_label": "张三", "score": 82, "tags": ["React", "TypeScript"], "recommendation": "建议进入面试；补充全栈案例" },
      { "candidate_label": "李四", "score": 61, "tags": ["Vue"], "recommendation": "可考虑，需补充考察" }
    ],
    "summary": {
      "matchConclusion": "已完成 2 位候选人与 JD 的批量匹配，当前最匹配为「张三」（82 分，优先推进）。",
      "topReasons": ["第 1 名「张三」：82 分，优先推进；建议进入面试"]
    }
  }
}