获取简历模板

接入方后端用 appSecret 拉取当前可用的在线简历模板,用于让用户先选模板,再创建编辑会话。不要在浏览器、App 或 iframe 中直接调用。

该接口免费,不扣开发者账户余额。列表可以短期缓存;创建会话仍应在用户开始编辑时进行。

接口

GET https://www.qmjianli.com/api_open/v1/templates
Authorization: Bearer {appSecret}

无需请求体,也没有查询参数。返回结果按模板热度排序。

响应字段

字段类型说明
templateIdnumber模板 ID,例如 1013。创建会话或生成 PDF 时写入 resumeData.setData.tplId
tagsstring逗号分隔标签,例如 通用,简洁
skinstring模板默认主题色,例如 #1575bf
coverUrlstring封面图地址,可直接用于列表展示。

成功返回

{
  "code": 1,
  "data": [
    {
      "templateId": 1013,
      "tags": "通用,简洁",
      "skin": "#1575bf",
      "coverUrl": "https://www.qmjianli.com/img/resume/template/online/1013.png"
    }
  ]
}

如何使用

  1. 接入方后端调用本接口,把列表返回给自己的前端。
  2. 前端展示 coverUrl,必要时再用 tags 做筛选。
  3. 用户选中后,把 templateId 提交给接入方后端。
  4. 创建会话或生成 PDF 时写入 resumeData.setData.tplId,详见 创建会话生成 PDF
已有简历再次编辑时,一般沿用上次 JSON 里的模板,不必再让用户重选。新简历才需要先拉模板列表。

错误码

错误码原因处理
APP_AUTH_REQUIRED请求没带 appSecret后端增加 Authorization: Bearer {appSecret}
APP_AUTH_FAILED密钥错误、已重置或应用已删除更新后端 appSecret

curl 示例

curl https://www.qmjianli.com/api_open/v1/templates \
  -H "Authorization: Bearer 你的appSecret"
全民简历开放平台 · 与个人简历账号完全独立