Skip to main content
POST
/
skills
/
{skill_key}
/
invoke
curl --request POST \
  --url https://api.dropcv.work/api/external/v1/skills/{skill_key}/invoke \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "params": {
    "query": "5 年 Java 微服务，Spring Boot，有大厂经验",
    "top_k": 5
  }
}
'
{
  "success": true,
  "skill_key": "candidate_search",
  "invocation_id": "inv_01HXXXXXXXXXXXXXXXXXXXXXXX",
  "result": {},
  "metadata": {
    "latency_ms": 234
  }
}

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.

Authorizations

​
Authorization
string
header
required

DropCV API Key。在 设置 → API Keys 生成，格式 drop_cv_<32 位随机字符>。

Path Parameters

​
skill_key
enum<string>
required

要调用的 skill 标识

Available options:
candidate_search,
candidate_profile_read,
jd_parse,
save_candidate,
candidate_update

Body

application/json
​
params
object
required

skill 的入参，字段由 skill 自身 schema 决定。详见 GET /skills/{skill_key} 或对应 skill 文档。

Response

调用成功

​
success
boolean
​
skill_key
string
Example:

"candidate_search"

​
invocation_id
string

本次调用的唯一 ID，格式 inv_

Example:

"inv_01HXXXXXXXXXXXXXXXXXXXXXXX"

​
result
object

skill 的输出，结构由 skill 自身决定

​
metadata
object