调用 skill

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": true,
  "skill_key": "candidate_search",
  "invocation_id": "inv_01HXXXXXXXXXXXXXXXXXXXXXXX",
  "error": {
    "message": "<string>"
  }
}

{
  "success": true,
  "skill_key": "candidate_search",
  "invocation_id": "inv_01HXXXXXXXXXXXXXXXXXXXXXXX",
  "error": {
    "message": "<string>"
  }
}

{
  "success": true,
  "skill_key": "candidate_search",
  "invocation_id": "inv_01HXXXXXXXXXXXXXXXXXXXXXXX",
  "error": {
    "message": "<string>"
  }
}

{
  "success": true,
  "skill_key": "candidate_search",
  "invocation_id": "inv_01HXXXXXXXXXXXXXXXXXXXXXXX",
  "error": {
    "message": "<string>"
  }
}

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": true,
  "skill_key": "candidate_search",
  "invocation_id": "inv_01HXXXXXXXXXXXXXXXXXXXXXXX",
  "error": {
    "message": "<string>"
  }
}

{
  "success": true,
  "skill_key": "candidate_search",
  "invocation_id": "inv_01HXXXXXXXXXXXXXXXXXXXXXXX",
  "error": {
    "message": "<string>"
  }
}

{
  "success": true,
  "skill_key": "candidate_search",
  "invocation_id": "inv_01HXXXXXXXXXXXXXXXXXXXXXXX",
  "error": {
    "message": "<string>"
  }
}

{
  "success": true,
  "skill_key": "candidate_search",
  "invocation_id": "inv_01HXXXXXXXXXXXXXXXXXXXXXXX",
  "error": {
    "message": "<string>"
  }
}

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

Show child attributes

概览

Skills API

能力参考

接入方式

RESTful API

Authorizations

Path Parameters

Body

Response