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
}
}{
"success": false,
"skill_key": "candidate_search",
"invocation_id": "inv_01HXXXXXXXXXXXXXXXXXXXXXXX",
"error": {
"code": "INVALID_API_KEY",
"message": "<string>"
}
}{
"success": false,
"skill_key": "candidate_search",
"invocation_id": "inv_01HXXXXXXXXXXXXXXXXXXXXXXX",
"error": {
"code": "INVALID_API_KEY",
"message": "<string>"
}
}{
"success": false,
"skill_key": "candidate_search",
"invocation_id": "inv_01HXXXXXXXXXXXXXXXXXXXXXXX",
"error": {
"code": "INVALID_API_KEY",
"message": "<string>"
}
}{
"success": false,
"skill_key": "candidate_search",
"invocation_id": "inv_01HXXXXXXXXXXXXXXXXXXXXXXX",
"error": {
"code": "INVALID_API_KEY",
"message": "<string>"
}
}Skills
调用 skill
所有 skill 调用走这一个端点。请求体固定为 { "params": { ... } }，params 的字段由 skill 自身的 schema 决定。
响应是统一 envelope：成功带 result，失败带 error，两种情况都带 invocation_id 便于审计排查。
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
}
}{
"success": false,
"skill_key": "candidate_search",
"invocation_id": "inv_01HXXXXXXXXXXXXXXXXXXXXXXX",
"error": {
"code": "INVALID_API_KEY",
"message": "<string>"
}
}{
"success": false,
"skill_key": "candidate_search",
"invocation_id": "inv_01HXXXXXXXXXXXXXXXXXXXXXXX",
"error": {
"code": "INVALID_API_KEY",
"message": "<string>"
}
}{
"success": false,
"skill_key": "candidate_search",
"invocation_id": "inv_01HXXXXXXXXXXXXXXXXXXXXXXX",
"error": {
"code": "INVALID_API_KEY",
"message": "<string>"
}
}{
"success": false,
"skill_key": "candidate_search",
"invocation_id": "inv_01HXXXXXXXXXXXXXXXXXXXXXXX",
"error": {
"code": "INVALID_API_KEY",
"message": "<string>"
}
}Authorizations
DropCV API Key。在 设置 → API Keys 生成，格式 drop_cv_<32 位随机字符>。
Path Parameters
要调用的 skill 标识
Available options:
candidate_search, candidate_profile_read, jd_parse, save_candidate, candidate_update Body
application/json
skill 的入参，字段由 skill 自身 schema 决定。详见 GET /skills/{skill_key} 或对应 skill 文档。
Was this page helpful?