工作流检索与下载
工作流模板目录独立于技能目录,网页入口为 工作流模板。介绍与 HTML 指南公开预览,ZIP 登录后按收费方式和权益下载:free 免费;metered 按量计费仅作标识,下载免费;buyout 一次购买,永久下载全部版本及后续更新。会员不自动获得买断权益。指南中的教程视频沿用原课程权限。
| 方法 | 路径 | 返回 / 用途 |
|---|---|---|
| GET | /api/public/workflows |
workflows,total,page,pageSize,categories |
| GET | /api/public/workflows/{slug} |
目录信息、当前版本及 releases 历史版本 |
| GET | /api/public/workflows/{slug}/download?version={version} |
原始 ZIP;需登录及相应权益,省略 version 使用当前版本 |
| GET | /api/public/workflows/{slug}/resources/{version}/{path} |
指定版本的包内指南、CSS、JS 和图片资源 |
列表参数:q 最多 200 字符,匹配名称或简介;category 最多 60 字符;featured 可为 true 或 false;page 默认 1;pageSize 默认 12,范围 1–50。分类值从响应的 categories 获取。
curl --fail-with-body --get 'https://link2.cn/api/public/workflows' \
--data-urlencode 'q=会议' --data-urlencode 'pageSize=12'
# 将 <slug> 替换为列表返回的真实标识
curl --fail-with-body 'https://link2.cn/api/public/workflows/<slug>'
详情包含 slug,name,summary,description,category,tags,steps,currentVersion,pricingMode,priceFen,downloadCount,publisher,featured,sortOrder,status,revision,updatedAt,releases。priceFen 为人民币整数分;publisher 为 {name} 或 null。每个 release 包含 version,sha256,bytes,guide,changelog,createdAt,article,publisher。锁定所需版本,使用该版本的 SHA-256 与字节数校验下载;不要把目录的当前版本摘要用于历史 ZIP。未发布或已删除模板不可访问;下架模板仅有效买断用户可查看与下载,不存在的版本返回 404。下载 GET 和 HEAD 均检查登录及购买权益,HEAD 不增加下载次数。
详情页默认展示按版本保存的站内整理稿 article(Markdown,最多 30000 字符);原版 HTML 通过次要入口查看,仍在隔离沙箱中运行。未提供整理稿的旧模板展示原有介绍和步骤,不会自动编造内容。包内 HTML/CSS/JS/图片使用相对路径;支持脚本交互,但不支持远程 fetch、外部 CDN、表单、任意 iframe、主站 Cookie 或持久化本地存储。下载的是作者原始 ZIP,在线隔离规则不会改写下载文件。
工作流下载统计
公开工作流列表及详情增加 downloadCount(非负整数)。只统计 ZIP 下载 GET 经完整性校验后成功返回的请求,按模板跨版本累计;HEAD、原版指南资源、无效版本与文件校验失败不计数。重复下载会重复累计,不代表独立使用人数;不回填历史。前端零值显示“新上架”,正值显示“已下载 X 次”。该字段只读,发布与后台编辑参数不接受设置;计数不修改模板目录更新时间和 revision。
下载与资源访问
ZIP 下载使用学堂网页会话,不接受中央 API Key 作为下载凭证;无登录返回 401,已登录但无买断模板权益返回 403。/api/public/ 路径前缀不表示 ZIP 可匿名获取。发布者也按相同下载权益校验。
只有位于指南目录内、扩展名为 HTML、CSS、JS、图片或字体的预览资源可匿名读取;其它包内文件需登录并校验下载权益。已下架模板的指南资源同样仅有效买断用户可读取。不要把 resources 路径当作免登录下载整个包的入口。
买断下单、权益查询和下载记录见工作流定价与购买。