生成 PDF

PDF 采用同步生成，接口直接返回临时下载地址，没有任务队列、jobId 或轮询。既可在官方编辑器中由用户导出，也可由接入方后端直接提交 resumeData 生成。

后端直接生成 PDF

使用 appSecret 调用。模板以 resumeData.setData.tplId 为准，可用 ID 来自模板列表接口；不传则使用默认模板 1013。不要再单独传 templateId。

POST https://www.qmjianli.com/api_open/v1/resumes/pdf
Authorization: Bearer {appSecret}
Content-Type: application/json

{
  "requestId": "PDF_20260815_0001",
  "resumeData": {
    "setData": { "tplId": 1038 },
    "basicInfo": {
      "name": "张三",
      "mobile": "13800000000",
      "email": "zhangsan@example.com"
    },
    "moduleData": []
  }
}

resumeData 可以直接使用解析简历返回的同名字段，也可以使用编辑器简历 JSON，最大 2MB。缺失的基础字段会由平台补齐，但不会替接入方保存。requestId 必填，规则与解析接口相同。

生成成功：

{
  "code": 1,
  "status": "success",
  "data": {
    "requestId": "PDF_20260815_0001",
    "templateId": 1038,
    "fileId": "F...",
    "downloadUrl": "https://www.qmjianli.com/api_open/v1/files/...",
    "expiresAt": "2026-08-16T08:00:00.000Z",
    "billing": {
      "action": "resume_pdf",
      "amountCents": 200,
      "amount": "2.00",
      "balanceCents": 9800,
      "balance": "98.00"
    }
  }
}

开发者账户必须至少完成过一次真实充值，注册赠送余额不能用于生成或导出简历 PDF。接口同步等待模板渲染和 PDF 生成，HTTP 客户端读取超时建议至少 120 秒。下载地址默认 24 小时有效，接入方需要长期保存时应及时转存。

该接口每次成功生成收费 2 元，只扣开发者账户余额；模板不存在、数据不合法或渲染失败时不收费或自动退款。

用户侧流程

用户点击编辑器顶部“导出 PDF”。
编辑器先保存当前临时草稿。
平台生成 PDF，通常等待数秒。
成功后浏览器立即打开下载地址。
父页面同时收到 exported 通知，可选择使用或忽略。

父页面通知

{
  "source": "QM_RESUME_EDITOR",
  "event": "exported",
  "externalResumeId": "R10001",
  "downloadUrl": "https://www.qmjianli.com/api_open/v1/files/...",
  "expiresAt": "2026-08-15T03:00:00.000Z"
}

下载地址只服务本次导出。平台不提供 PDF 历史管理，也不保证过期后还能打开；需要时重新导出。

费用与失败

编辑器内每次导出 PDF 同时从开发者人民币账户和当前会话额度扣 2 元。
后端直接生成 PDF 每次只从开发者账户扣 2 元。
开发者账户未产生过真实充值流水时返回 PDF_EXPORT_RECHARGE_REQUIRED，且不会扣费。
渲染失败时，本次费用会自动退回两边余额。
会话额度不足时返回 SESSION_BALANCE_INSUFFICIENT；开发者余额不足时返回 DEVELOPER_BALANCE_INSUFFICIENT。
PDF 生成期间不要重复点击导出。