快速开始

先从无需凭证的技能检索开始：

curl --fail-with-body --get 'https://link2.cn/api/public/skillhub' \
  --data-urlencode 'q=跨境' --data-urlencode 'page=1' \
  --data-urlencode 'pageSize=12'

响应直接返回 skills,total,page,pageSize,industries,tags,publisher。使用结果中的真实 slug 查询详情，不猜测资源 ID：

curl --fail-with-body 'https://link2.cn/api/public/skillhub/<slug>'

查询本人工作区

在灵途造物创建 API Key 并授权学堂，再通过统一 CLI 或 Agent 的安全凭证配置使用。以下 LINGTU_API_KEY 表示安全注入当前进程的用户密钥，不是应用 client_secret：

curl --fail-with-body 'https://link2.cn/api/me/skills' \
  -H "Authorization: Bearer ${LINGTU_API_KEY}"

中央 API Key 只在创建时展示一次。不要把真实密钥提交到代码仓库、URL、截图或日志中。

处理结果

先检查 HTTP 状态，再按接口的实际响应结构读取业务数据。不要套用其它产品的 code 或 data 信封。创建、上传和提交请求发生超时时，先查询状态，不自动重复写入。