获取简历模板
接入方后端用 appSecret 拉取当前可用的在线简历模板,用于让用户先选模板,再创建编辑会话。不要在浏览器、App 或 iframe 中直接调用。
该接口免费,不扣开发者账户余额。列表可以短期缓存;创建会话仍应在用户开始编辑时进行。
接口
GET https://www.qmjianli.com/api_open/v1/templates
Authorization: Bearer {appSecret}无需请求体,也没有查询参数。返回结果按模板热度排序。
响应字段
| 字段 | 类型 | 说明 |
|---|---|---|
| templateId | number | 模板 ID,例如 1013。创建会话或生成 PDF 时写入 resumeData.setData.tplId。 |
| tags | string | 逗号分隔标签,例如 通用,简洁。 |
| skin | string | 模板默认主题色,例如 #1575bf。 |
| coverUrl | string | 封面图地址,可直接用于列表展示。 |
成功返回
{
"code": 1,
"data": [
{
"templateId": 1013,
"tags": "通用,简洁",
"skin": "#1575bf",
"coverUrl": "https://www.qmjianli.com/img/resume/template/online/1013.png"
}
]
}如何使用
- 接入方后端调用本接口,把列表返回给自己的前端。
- 前端展示
coverUrl,必要时再用tags做筛选。 - 用户选中后,把
templateId提交给接入方后端。 - 创建会话或生成 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"