文档
免费构建

快速开始

简介

用你自己的代码列出、修改和发布你的 Setherion 应用，并让它们做好上架应用商店的准备。

Setherion API 让你通过脚本、服务器或自动化流程来处理你的应用。它可以列出应用，根据一条指令修改某个应用，发布某个应用，并为 Google Play 和 App Store 做好上架准备。这和你在编辑器里做的是同一份工作。

API 在所有套餐上都能使用，包括 Free。修改应用消耗积分的方式和在编辑器里一样，撰写商店页面会消耗少量积分，并且需要 Pro。

基础地址

text
https://www.setherion.com/api/v1

请保留 www。不带它的地址会发生重定向，而重定向会丢掉 Authorization 请求头，请求到达时就不带你的密钥了。

第一个请求

在 Settings 里，再打开 API 密钥，创建一个密钥，然后用它列出你的应用：

bash
curl https://www.setherion.com/api/v1/projects \
  -H "Authorization: Bearer $SETHERION_API_KEY"
json
{
  "ok": true,
  "total": 1,
  "truncated": false,
  "offset": 0,
  "nextOffset": null,
  "projects": [
    {
      "id": "7c1e4a52-9b0d-4f3e-8a61-2d5f0c9e7b14",
      "name": "Coffee shop",
      "description": null,
      "url": "https://coffee-shop.setherion.app",
      "updatedAt": "2026-09-19T10:42:07.000Z"
    }
  ]
}

接口

方法路径作用所需权限
GET/projects列出你的应用，支持搜索和分页任意
POST/projects/{id}/edit根据指令修改应用编辑者
POST/projects/{id}/publish让应用上线编辑者
GET/projects/{id}/store应用商店方面已经准备好的内容，以及后续步骤查看者
GET/projects/{id}/store/privacy应用商店的隐私问卷回答，从代码中读取查看者
POST/projects/{id}/store/listing撰写商店页面编辑者

权限就是你在这个应用上的角色。查看者足以读取内容，要做任何修改或消耗积分，则需要编辑者。所有者和管理员两者都具备。如果某个应用你的权限达不到调用所需的级别，就会返回 404，和应用不存在时一样。

每个响应都带有 ok

每个响应都是带有 ok 字段的 JSON。请求被拒绝时，ok 为 false，状态码说明问题的类型，error 是一句可以直接展示给用户的话：

json
{ "ok": false, "error": "No such app on this account." }

所有状态码、所有限制以及确切的错误信息，见错误与限制。

什么会消耗积分

调用积分
列出、发布、商店指南、隐私问卷回答无
修改与在编辑器里修改相同，从为这个应用付费的账户中扣除
撰写商店页面少量，Pro 及以上套餐。如果没有生成页面，会退还。

通过 AI 助手使用

如果你想让 Claude、ChatGPT、Cursor 或 VS Code 替你完成这些事，不需要直接使用 API。请改为连接 AI 助手：它把这些相同的调用作为工具提供，而且你无需密钥，直接登录即可。

这个页面对你有帮助吗？

下一页

身份验证

加入社区

提问、交流想法，看看别人在构建什么。