candidate_update

candidate_update 修改候选人的允许字段。只传你要改的字段，未传的不变。

参数

字段	类型	必填	说明
`candidate_id`	uuid	是	候选人 ID
`fields`	object	是	要修改的字段字典（至少一个）

可改字段（白名单）

按语义分组：

基础

full_name · gender · birth_year · age · current_city · current_status · hometown

联系

phone · email · wechat · linkedin_url

教育

highest_education · school_name · major · graduation_year

工作 + 薪资

current_company · current_title · job_level · years_of_experience · current_company_tenure · management_experience · team_size · salary_min · salary_max · salary_unit · salary_period

标签（数组字段）

school_level_tags · industries · functions · skills · preferred_locations · private_judgement_tags · custom_tags

备注（文本字段）

interview_notes · personality_notes · concerns · motivation · recommendation_notes

不可改字段

id / user_id / ai_*_tags（AI 建议标签自动维护） / dedup_fingerprint / field_meta / created_at / updated_at / profile_status 如果 fields 里包含上述任何一个，请求会返回 INVALID_PARAMS (422)。

{
  "candidate_id": "uuid",
  "updated_fields": ["phone", "current_title", "interview_notes"]
}

示例

curl -X POST https://api.dropcv.work/api/external/v1/skills/candidate_update/invoke \
  -H "Authorization: Bearer $DROPCV_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "params": {
      "candidate_id": "...",
      "fields": {
        "current_title": "技术总监",
        "current_company": "新创业公司",
        "interview_notes": "5/12 一面通过，技术功底扎实",
        "skills": ["Python", "Go", "Rust"]
      }
    }
  }'

权限

需要 write 权限。

审计

修改后的每个字段都会在 candidate.field_meta 留下来源（source: external_api、api_key_id、修改时间），便于将来追溯。

概览

Skills API

能力参考

接入方式

RESTful API

candidate_update

参数

可改字段（白名单）

基础

联系

教育

工作 + 薪资

标签（数组字段）

备注（文本字段）

不可改字段

返回

示例

权限

审计

​参数

​可改字段（白名单）

​基础

​联系

​教育

​工作 + 薪资

​标签（数组字段）

​备注（文本字段）

​不可改字段

​返回

​示例

​权限

​审计

参数

可改字段（白名单）

基础

联系

教育

工作 + 薪资

标签（数组字段）

备注（文本字段）

不可改字段

返回

示例

权限

审计