Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.dropcv.work/llms.txt

Use this file to discover all available pages before exploring further.

save_candidate 把简历入库。必须先通过 /files/upload 上传附件拿到 file_id，再调本 skill。

​
参数

字段类型必填说明
candidate_profile_textstring (1-20000 字符)是简历结构化文本（姓名 / 职位 / 经历 / 技能 等，换行分隔）
attachment_file_idstring是来自 /files/upload 的 file_id
source_urlstring | null否简历来源页面 URL（可选）

​
返回

{
  "candidate_id": "uuid",
  "profile_status": "..."
}

​
示例

# 步骤 1：上传附件
FILE_ID=$(curl -s -X POST https://api.dropcv.work/api/external/v1/files/upload \
  -H "Authorization: Bearer $DROPCV_API_KEY" \
  -F "file=@resume.pdf" -F "mime_type=application/pdf" | jq -r .file_id)

# 步骤 2：入库
curl -X POST https://api.dropcv.work/api/external/v1/skills/save_candidate/invoke \
  -H "Authorization: Bearer $DROPCV_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{
    \"params\": {
      \"candidate_profile_text\": \"姓名：张三\\n职位：高级后端\\n公司：字节跳动\\n经验：5 年\\n技能：Python, Go\",
      \"attachment_file_id\": \"$FILE_ID\"
    }
  }"

​
权限

需要 write 权限。

​
错误

  • FILE_NOT_FOUND (404) — file_id 不存在 / 已过期 / 不是这个 user 上传的
  • INSUFFICIENT_PERMISSION (403) — key 没开 write 权限

​
审计

入库后的候选人在 DropCV 后台会标记 source = external_api，未来可在 dashboard 筛选 “AI 入库的候选人”。