手动上传 API

如果您希望使用自己的构建器 CI/CD 流水线，而不是利用 Itero 的 GitHub App 集成，那么本页面就是为您准备的！通过手动将您的 zip 文件提交到 Itero，您的 CI 流水线将不受 Itero 上席位许可证数量的限制来触发云构建器。

🚨

此流程仅适用于专业版计划。API 按原样提供。有关与您的系统集成的支持，我们提供咨询服务。发送邮件至 support@plasmo.com 获取更多详情。

下载 API 密钥

转到您的扩展程序设置页面并下载 API 密钥。密钥是一个 JSON 文件，格式如下：


{
  "itero": {}
}

通过 GitHub Action 提交

您可以使用密钥与 BPP GitHub Action 自动将您的扩展程序上传到 Itero。只需将 itero 密钥添加到您现有的 BPP 密钥中，或作为单独的密钥工作流。

确保您的 BPP 版本为 v3.3.0 或更高版本。

通过 API 调用提交

首先，创建您的扩展程序的 zip 文件。然后，按照以下流程操作：

1. POST `https://itero.plasmo.com/api/submit/upload`

此端点会为您提供一个签名 URL，用于上传您的扩展程序。

请求体必须包含 keys.itero 对象，例如：


const keys = JSON.parse(await readFile("./keys.json", "utf8")) // keys.json 是您从设置页面下载的文件
 
...
 
const resp = await fetch("https://itero.plasmo.com/api/submit/upload", {
  method: "POST",
  headers: {
      "Content-Type": "application/json"
    },
  body: JSON.stringify(keys.itero)
})
 
const data = await resp.json()
 
console.log(data)

响应是一个包含上传 URL 的 JSON：


{
  "url": "signed-upload-url"
}

2. PUT signed-upload-url

获取步骤 1 中的响应 URL，并向其发出 PUT 请求，附带 zip blob。确保 Content-Type 头为 application/zip。

3. POST `https://itero.plasmo.com/api/submit/sign`

上传完成后，您需要调用签名端点来完成流程，并更新将提供给 Beta 测试人员的扩展程序包。

请求体必须包含与步骤 1 相同的 keys.itero 对象。