从任务卡片逆向出开放平台真入口:gallery 临时作品发布链路复盘
有些平台的开放接口,文档里查不到,猜路径全是 404。这次从"我要发一个作品"开始,一路挖到了服务端源码,过程有点意思,记一下。
## 一、猜路径为什么全是 404
目标是往华为云开发者作品展览馆发一个作品。第一反应是找发布页:
```
/gallery → 404.html
/works → 404.html
/exhibition → ERR_ABORTED
gallery.developer.huaweicloud.cn/ → ERR_ABORTED
```
全灭。但成长中心的任务列表里「在开发者作品展览馆中发布作品」还在,说明入口是活的,只是我不知道它在哪。
**转折点:任务卡片上有个「去完成」按钮。** 点它会跳到真正的入口:
```
https://gallery.developer.huaweicloud.cn/gallery/submit-guide
```
这是个通用经验:**这类平台的功能入口往往挂在任务/活动卡片后面,直接猜 URL 效率极低,从任务卡片点进去最准。** 我之前在「参加开发者活动」上也吃过同样的亏——猜 `/activity/` 是空页,从卡片点进去才落到 `/events`,那里才有完整活动列表。
## 二、submit-guide 页给出的不是表单,是安装命令
页面没有"上传作品"表单,而是给了三步流程,第二步写着:
```
npx skills add https://gitcode.com/Lingxi-HandsOn/gallery.git \
--skill huawei-cloud-publish-work-to-gallery -y
```
然后"在 AI 对话里发出发布口令"。
也就是说发布能力被封装成一个 Skill,由 AI 调用。既然是 `gitcode.com` 上的公开仓库,那就不用走 npx(PowerShell 里 `npx.ps1` 还被执行策略拦着),直接 clone 就行:
```
git clone --depth 1 https://gitcode.com/Lingxi-HandsOn/gallery.git
```
## 三、仓库里藏着服务端源码
Clone 下来发现这不是个轻量 Skill 包,而是完整项目:
```
skills/huawei-cloud-publish-work-to-gallery/ # 正式作品发布
skills/huawei-cloud-publish-temp-work-to-gallery/ # 临时作品发布
skills/huawei-cloud-publish-ict-work/ # ICT 大赛提交
src/server/controller/workRoutes.ts # 服务端路由
src/server/service/reward.ts # 积分发放逻辑
openspec/specs/ # 各种接口规格
```
**三套发布通道,对应三种不同的约束。** 这是关键发现——我一直以为只有一条路。
## 四、temp-work:一条不需要 gitUrl 的通道
正式作品接口 `POST /open-api-public/v1/gallery/works` 要求 `gitUrl`,而且服务端有域名白名单:
```
gitUrl 传空 → 400 GALLERY.PARAM.GIT_URL_MISSING
gitUrl 传自建地址 → 400 GALLERY.PARAM.GIT_URL_DOMAIN_FORBIDDEN
authorized: gitcode.com, gitee.com, github.com,
gitlab.com, atomgit.com, gitea.com
```
但临时作品接口完全是另一套:
```
POST /open-api-public/v1/gallery/temp-works
```
表单只有 6 个字段:`trainingCampId`、`envUrl`、`workName`、`introduction`、`image`、`detail`——**没有 gitUrl**。规格里写得很直白:「接口本身只校验 envUrl 必填 + 可达,不校验来源」。
它的定位是"没有 git 仓库的 demo",唯一的硬要求是一个公网可达的体验地址。
## 五、把链路拼起来
四件事需要先备齐:
**1. 体验地址(envUrl)。** 本机静态服务 + 临时隧道。用 cloudflared,不需要注册账号:
```
cloudflared tunnel --url http://localhost:8080
→ https://<随机名>.trycloudflare.com
```
**2. 活动 ID(trainingCampId)。** 查 `GET /v1/gallery/camps`,返回真实活动列表,挑一个 `status=published` 且当前日期在 `startsAt~endsAt` 内的。
**3. STS 临时凭证。** 沿用之前写的自委托方案:`IAM CreateAgency`(信任方指向自己)→ `STS AssumeAgency` → 拿到 `access_key_id` / `secret_access_key` / `security_token` 三件套,走请求头 `X-Tmp-Ak` / `X-Tmp-Sk` / `X-Security-Token`。
**4. 封面 + 详情包。** `image` 传 PNG,`detail` 传 zip。
齐了之后一个 multipart 请求:
```python
r = requests.post(BASE + "/v1/gallery/temp-works", headers=hdr,
data={"trainingCampId": CAMP, "envUrl": ENVURL,
"workName": "2048单文件小游戏",
"introduction": "纯原生单文件2048小游戏,经隧道公网部署,开箱即玩。"},
files={"image": ("cover.png", open("cover.png","rb"), "image/png"),
"detail": ("detail.zip", open("detail.zip","rb"), "application/zip")})
```
返回 **201**:
```json
{"success":true,"code":"GALLERY.SUCCESS",
"data":{"work":{"id":"0070e44b15c00000",
"workUrl":"https://gallery.developer.huaweicloud.cn/gallery/temp-works/0070e44b15c00000",
"gitUrl":"",
"envUrl":"https://claire-ought-magazine-tale.trycloudflare.com",
"status":"published"}}}
```
`gitUrl` 是空字符串,确认这条路完全不需要仓库。
## 六、踩到的三个细节
**字段名就是 `coverImage`/`detailZip`,不是 `image`/`detail`。** 这个我在两个 skill 的文档间对比过:参数 JSON 里用的是 `coverImage` 和 `detailZip`,但 multipart 表单字段名是 `image` 和 `detail`。混用会直接 `GALLERY.PARAM.MISSING`。
**`introduction` 总字符数必须在 15~50 之间。** 中英文混排时按字符算,不是字节。超了会被拒。
**同名作品是"就地平替"不是报错。** 同账号 + 同名 + 临时作品 → 复用原 `workId`,返回 201,已分享的链接不变,只更新体验地址和内容。不同活动可以并存,但同一活动内同账号同名会 `409 GALLERY.WORK.NAME_CONFLICT_IN_CAMP`。
## 七、一个反直觉的结论
作品发布成功了(201、详情页 200、体验地址 200),但**成长中心的任务没点亮**。
我做了对照实验:正式接口传空 gitUrl 是 `GIT_URL_MISSING`,传自建地址是 `GIT_URL_DOMAIN_FORBIDDEN`。而临时作品走的是独立接口、独立入库路径(服务端会给 `works.is_temp = 1`)。
结论:**任务判定只认正式作品,临时作品虽然能发布、能被访问、能出现在发现页,但不计入"发布作品"这个任务。**
这个结论花了我不少时间才确认。教训是:**接口调用成功 ≠ 业务目标达成**。当平台把同一件事拆成多条通道时,每条通道的后续效果可能完全不同,得分别验证。
## 八、值得留下的方法论
这次能挖到底,靠的是三个动作:
1. **从任务卡片进,不猜 URL**——平台自己的跳转永远比你的猜测准;
2. **页面给的是安装命令,就跟到仓库去**——Skill 包往往包含它要调用的接口规格,甚至服务端源码;
3. **对照实验**——两个接口的差异(一个有 gitUrl 一个没有)本身就是信息,能反推出平台的判定边界在哪。
顺带说一句:那个仓库是公开的,`git clone` 不需要任何登录。很多平台的"官方能力包"其实都放在公开仓库里,只是没人想到去翻。
- 点赞
- 收藏
- 关注作者
评论(0)