Copy

发布 API 用于把项目当前的生成结果发布为可访问的线上应用，并查询当前线上版本和历史发布记录。基础地址：https://meoo.com/open/v1

支持范围

当前 OpenAPI 发布能力支持 type=web 项目的默认 Web 发布。采用 Mise 协议的源码项目可通过 mise.toml 选择静态站点（mode=static）或 HTTP 服务（mode=server）。无需 AI 时的项目要求和最小示例见项目导入与发布。创建接口虽然也接受 app 和 miniprogram，但这只表示可以创建和继续操作对应类型的项目，不表示 OpenAPI 已提供其原生发布渠道。

app：本接口不会生成或返回 APK、IPA 等安装包。
miniprogram：本接口不会提交到微信、抖音等小程序平台。
请求体不能选择发布渠道；发布项目时可省略请求体、传 {}，或通过可选 expires_at 设置发布访问过期时间（Unix 毫秒时间戳）。省略 expires_at 或传 null 表示永久有效。

在专用发布接口或渠道参数开放前，不要对 app、miniprogram 项目调用本接口。查询当前版本和发布记录的公开契约也以默认 Web 发布记录为准。

发布安全审核

平台会在发布流程中进行内容安全审核。接入方无需单独发起审核，按接口返回结果处理即可。

返回结果	处理方式
静态直传 `403 forbidden`	根据 `detail` 修改内容，重新 prepare、上传并 complete
静态直传 `400 artifact_invalid`	根据 `detail` 调整文件格式或大小，重新上传
静态直传 `503`	稍后用原 `release_token` 重试 complete，无需重新上传
普通发布 `release.failed`，`code=content_violation`	根据 `message` 修改项目内容，再用新的发布 Key 发起发布

静态直传审核失败不会替换当前线上版本。排查问题时请提供错误码、错误说明和 trace_id。

直接上传静态产物

已经在接入方完成构建时，使用两个 API 和一次 PUT 上传，跳过 Meoo 沙箱和构建过程：

POST /projects/{project_id}/releases/prepare，提交 runtime=static 和静态 zip 元数据，入口文件需要为 index.html，获取临时 PUT 地址与 release_token；
按响应中的 method、URL、headers 将 zip 直接 PUT 到对象存储；
POST /projects/{project_id}/releases/complete，只提交 release_token，等待自动解压并审核，通过后创建并激活正式 Release。

所需权限：release.write artifact.content_length 必传，MD5 checksum 可选。当前仅支持 artifact.type=static_site、content_type=application/zip，zip 根目录必须包含 index.html。complete 可使用相同 Token 重试，不接受客户端指定版本号、内部项目 ID 或 OSS 路径。上传必须携带响应 upload.headers 中的全部 Header，包括签名绑定的 x-oss-forbid-overwrite: true。首次 PUT 成功后同一对象不能再次上传；省略或修改该 Header 会导致签名校验失败。若 PUT 结果不确定，应调用 complete 确认；修改产物必须重新 prepare，获取新对象地址。升级前未带禁止覆盖约束的票据在 complete 返回 409 release_state_expired，需要重新 prepare/upload；已经成功的旧发布仍可重放。 complete 返回普通 JSON，不是 SSE；接口内部等待入口文件就绪并执行审核，接入方无需另调审核查询接口。请求超时或返回可重试错误时，用原 release_token 重试。普通源码发布仍通过 SSE 等待 release.completed。

静态发布的访问有效期

POST /projects/{project_id}/releases/prepare 可在请求体顶层传 expires_at：整数或 null，Unix 毫秒时间戳，合法整数范围为 1～253402271999999。省略或传 null 表示永久有效。请设置未来时间，并为上传、解压和审核预留时间；到期后发布访问地址返回 404。 prepare 请求示例（content_length 请替换为实际 ZIP 字节数；expires_at 为示例时间，请替换为实际未来时间）：

{
  "runtime": "static",
  "expires_at": 1893456000000,
  "artifact": {
    "type": "static_site",
    "filename": "dist.zip",
    "content_type": "application/zip",
    "content_length": 1024
  }
}

prepare 响应中的 upload.expires_at 是上传链接的到期时间，与网站的访问到期时间不同；设置网站有效期不会延长上传链接或 release_token 的有效期。 POST /projects/{project_id}/releases/complete 仍只接受 release_token，不能在 complete 中新增或修改 expires_at。服务端沿用 prepare 中的值；成功响应返回 expires_at（Unix 毫秒时间戳或 null），重试不会延长有效期。 complete 成功响应示例：

{
  "release_id": "123456789012345678",
  "version": 7,
  "artifact_id": "example-artifact",
  "runtime": "static",
  "artifact_type": "static_site",
  "status": "active",
  "access_url": "https://demo.meoo.com",
  "published_at": 1786410060000,
  "expires_at": 1893456000000
}

完整请求、响应和两种团队身份模式见仅部署接入：上传静态产物。

静态产物的文件要求

内容	支持范围
静态产物	上传可由平台自动解压的 ZIP，根目录有 `index.html`；解压后最多 10000 个文件，总量最多 512 MiB
文本	UTF-8 的 HTML、HTM、JS、MJS、CJS、CSS、JSON、MAP、SVG、TXT、XML、MD、WEBMANIFEST；单文件最多 4 MiB，合计最多 8 MiB
图片	PNG、JPG、JPEG、WEBP、GIF、BMP；最多 100 张，单张最多 10 MiB，合计最多 50 MiB
辅助资源	允许 WOFF、WOFF2、TTF、OTF、EOT 字体和 ICO 图标随包发布
其他类型	暂不支持，包括预压缩的 `.gz`、`.br`、视频和 WASM；超出范围返回 `artifact_invalid`

发布项目

POST /projects/{project_id}/releases

所需权限：release.write 发布过程通过 Server-Sent Events（SSE）持续返回进度。客户端断开不会取消后台发布。

请求头

请求头	必填	说明
`Authorization`	是	OAuth Access Token 或 API Key
`Accept: text/event-stream`	建议	表明客户端接收 SSE
`Content-Type: application/json`	否	传递 JSON 请求体时使用（包括 expires_at 或空对象 {}）
`Idempotency-Key`	是	1～128 个可见 ASCII 字符；用于安全重试

同一凭证、用户、项目和 Idempotency-Key 在 24 小时内只会启动一次发布。网络中断后使用同一个 Key 重连，会重新返回已保存的发布事件。

请求体

请求体可以省略、传空对象 {}，或仅包含可选字段 expires_at，不接受其他字段。

字段	类型	必填	说明
expires_at	integer \| null	否	发布访问过期时间，Unix 毫秒时间戳；整数范围 1～253402271999999。省略或 null 表示永久有效。

请设置未来时间并为构建、审核和部署预留时间；到期后发布访问地址返回 404。下面示例中的时间戳需替换为实际未来时间；永久发布使用 {} 或 {"expires_at":null}。重试同一次发布时，保留原 Idempotency-Key 和相同 expires_at，不要每次重试重新计算到期时间。同一 Key 修改 expires_at 会产生幂等冲突；需要使用不同有效期重新发布时，应使用新的 Key。省略 expires_at 与传 null 都表示永久有效。

请求示例

curl --no-buffer \
  --request POST \
  --url "https://meoo.com/open/v1/projects/event-signup-demo/releases" \
  --header "Authorization: Bearer ${ACCESS_TOKEN}" \
  --header "Accept: text/event-stream" \
  --header "Content-Type: application/json" \
  --header "Idempotency-Key: release_20260813_001" \
  --data '{"expires_at":1893456000000}'

事件列表

事件	说明	关键字段
`release.started`	发布已开始	`operation&amp;#95;id`、`started&amp;#95;at`
`release.progress`	发布进度更新	`operation&amp;#95;id`、`progress`、`message`、`timestamp`
`release.completed`	发布成功	operation_id、release_id、version、access_url、published_at、expires_at
`release.failed`	发布失败	`operation&amp;#95;id`、`code`、`message`、`failed&amp;#95;at`

事件中的时间字段均为 Unix 毫秒时间戳。每个事件还包含递增的 SSE id。 release.failed.message 会返回可安全展示给用户的失败原因，例如构建产物异常、代码构建失败或额度不足。可由代码修复的失败会在同一字段中附带经过脱敏的构建错误，供 AI 定位文件、行列和编译问题；字段最长 4000 字符，不会透传凭证、内部地址或原始上游响应。

事件流示例

id: 1
event: release.started
data: {"operation_id":"rel_01JEXAMPLE","started_at":1786410000000}

id: 2
event: release.progress
data: {"operation_id":"rel_01JEXAMPLE","progress":60,"message":"正在部署应用","timestamp":1786410030000}

id: 3
event: release.completed
data: {"operation_id":"rel_01JEXAMPLE","release_id":"123456789012345678","version":7,"access_url":"https://*.mobao.app","published_at":1786410060000,"expires_at":1893456000000}

收到 release.completed 或 release.failed 后，本次发布结束。SSE 注释帧是保持连接使用的心跳，可以忽略。 release.completed.expires_at 为本次发布的访问过期时间，类型为 integer | null；整数使用 Unix 毫秒时间戳，null 表示永久有效。接入方应连同 release_id、access_url 一起保存该字段；事件重放不会延长发布有效期。

发布失败示例

event: release.failed
data: {"operation_id":"rel_01JEXAMPLE","code":"release_failed","message":"应用代码构建失败，请检查代码后重试\n构建失败: src/App.tsx(12,3): error TS2322: Type 'string' is not assignable to type 'number'","failed_at":1786410060000}

常见发布错误码：

错误码	说明
`duplicate&amp;#95;release`	项目已有发布任务正在进行
`project&amp;#95;not&amp;#95;found`	项目不存在或当前用户不能访问
`content&amp;#95;violation`	项目内容未通过安全检查
`quota&amp;#95;exceeded`	当前账号额度不足
`release&amp;#95;failed`	发布失败
`release&amp;#95;interrupted`	发布任务中断，需要使用新的 `Idempotency-Key` 重试

如果连接在发布过程中断，先用原 Idempotency-Key 重连。只有服务端明确返回 release_interrupted 或恢复状态已过期时，才生成新的 Key 发起新发布。

取消当前发布

POST /projects/{project_id}/releases/unpublish

所需权限：release.write。调用身份必须拥有项目 Owner 或 Admin 权限。该接口复用应用取消发布流程：取消当前 active Release，并同步移除关联橱窗展示和模板公开指针；历史发布记录仍然保留。请求体可以省略或传空对象 {}，不接受 expires_at。此接口用于主动取消当前发布，不用于设置、延长或清除发布有效期。

curl --request POST \
  --url "https://meoo.com/open/v1/projects/event-signup-demo/releases/unpublish" \
  --header "Authorization: Bearer ${ACCESS_TOKEN}" \
  --header "Content-Type: application/json" \
  --data '{}'

成功返回：

{
  "status": "unpublished",
  "previous_version": "7",
  "showcase_removed": true,
  "template_unpublished": false,
  "unpublished_at": 1786410060000
}

项目当前未发布时返回 404 release_not_found；项目仍在发布过程中时返回 409 release_conflict。

查询当前线上版本

GET /projects/{project_id}/releases/current

所需权限：release.read 返回项目当前对外提供服务的版本。当前此接口不返回 expires_at；接入方需要展示或管理发布有效期时，请保存发起发布时的 expires_at，以及 complete 成功响应或 release.completed 事件返回的值。

请求示例

curl --request GET \
  --url "https://meoo.com/open/v1/projects/event-signup-demo/releases/current" \
  --header "Authorization: Bearer ${ACCESS_TOKEN}"

响应字段

字段	类型	说明
`release&amp;#95;id`	string	发布记录标识，以字符串返回
`version`	integer	版本号
`status`	string	当前固定为 `active`
`access&amp;#95;url`	string \| null	完整 HTTPS 应用访问地址；暂未生成时为 `null`
`published&amp;#95;at`	integer	发布时间，Unix 毫秒时间戳

响应示例

{
  "release_id": "123456789012345678",
  "version": 7,
  "status": "active",
  "access_url": "https://demo.meoo.com",
  "published_at": 1786410060000
}

项目尚未发布时返回 404，错误码为 release_not_found。

查询发布记录

GET /projects/{project_id}/releases

所需权限：release.read 按版本从新到旧分页返回项目的发布记录。

Query 参数

参数说明

page_size（integer，可选）：每页数量，默认 20，最大 100
page_token（string，可选）：上一页响应中的分页令牌

请求示例

curl --request GET \
  --url "https://meoo.com/open/v1/projects/event-signup-demo/releases?page_size=20" \
  --header "Authorization: Bearer ${ACCESS_TOKEN}"

响应字段

字段	类型	说明

响应示例

{
  "items": [
    {
      "release_id": "123456789012345678",
      "version": 7,
      "status": "active",
      "created_at": 1786410000000,
      "finished_at": 1786410060000,
      "current": true
    },
    {
      "release_id": "123456789012345600",
      "version": 6,
      "status": "succeeded",
      "created_at": 1786320000000,
      "finished_at": 1786320060000,
      "current": false
    }
  ],
  "next_page_token": "eyJ2IjoxLCJjdXJzb3IiOiJleGFtcGxlIn0"
}

常见错误

HTTP 状态	说明
`400`	Idempotency-Key、请求体或分页参数不符合要求；expires_at 类型错误、非整数、为 0 或超出范围时返回 invalid_request
`403`	缺少发布权限，或当前账号/项目不能发布
`404`	项目或当前线上版本不存在，或当前用户不能访问
`409`	项目正在发布，或可恢复的发布状态已失效
`429`	发布或查询频率超过限制
`500` / `503`	发布服务暂时不可用

发布接口会使用项目当前的生成结果。调用前请确保 AI 生成任务已经完成，并由你的产品向用户明确展示即将发布的项目。

从已有源码开始

使用源码导入 API创建新 Web 项目，等待 import.completed；如果开启 AI，再通过原有 Agent 接口等待 Run 完成，最后调用普通发布接口。导入不会自动发布，也不支持覆盖导入。导入完成前请勿编辑、启动 Agent、发布或删除该项目。发布的是当前源码，接入方无需传 commitId 或手动推送 NAS。

​支持范围

​发布安全审核

​直接上传静态产物

​静态发布的访问有效期

​静态产物的文件要求

​发布项目

​请求头

​请求体

​请求示例

​事件列表

​事件流示例

​发布失败示例

​取消当前发布

​查询当前线上版本

​请求示例

​响应字段

​响应示例

​查询发布记录

​Query 参数

​请求示例

​响应字段

​响应示例

​常见错误

​从已有源码开始

支持范围

发布安全审核

直接上传静态产物

静态发布的访问有效期

静态产物的文件要求

发布项目

请求头

请求体

请求示例

事件列表

事件流示例

发布失败示例

取消当前发布

查询当前线上版本

请求示例

响应字段

响应示例

查询发布记录

Query 参数

请求示例

响应字段

响应示例

常见错误

从已有源码开始