外观
开放平台(开发者门户)
开放平台是 ISV 与平台开发者上架应用、数据模板、知识包与素材包的门户。你可以在此创建上架条目、上传版本、提交审核并在通过后正式上架,同时管理 API 凭证与开发团队。文档、API 参考、Try it 在线调试与 Manifest 校验对未登录访客公开。
谁能用
开放平台根据登录状态与组织角色划分使用权限:
| 角色 / 身份 | 访问范围 | 权限说明 |
|---|---|---|
| 未登录访客 | 文档与工具 | 可浏览「快速开始」「指南」「API 参考」「工具与 SDK」「Manifest 校验」「签名密钥」「契约等级」、App Bridge 以及「平台能力」。顶栏显示「登录」按钮 |
isv.developer(开发者) | 「应用」「API 凭证」「团队」 | 创建条目、修改上架信息、上传版本、提交审核、上架版本、回复用户评价。对 API 凭证仅支持只读查看 |
isv.admin(管理员) | 全部功能 | 拥有开发者全部权限,外加邀请成员、调整角色、停用或重新启用成员、重发邀请或重置密码,以及创建、轮换和删除 API 凭证 |
注意
- 访问「应用」「API 凭证」「团队」必须登录,且账号必须属于某个开发者组织。登录后若不属于任何开发者组织,界面提示「这个账号不属于任何开发者组织」「请联系平台运营创建开发者组织并发出邀请。」。
- 平台开发者组织的成员由运营方在身份中心按角色管理。「团队」页面提示「平台开发者组织的成员由运营方管理」;「API 凭证」页面提示「平台开发者组织的凭证由平台管理」「由运营方管理,不在这里创建或轮换。」。
- 非管理员查看凭证时,界面提示「你只能查看」,说明创建、轮换和删除凭证需要管理员角色。
- 开发者看不到其他 ISV 的任何条目或数据,也看不到任何租户业务数据。访问其他开发者的应用时页面提示找不到。用户评价均为匿名展示(不包含租户 ID),安装量仅显示聚合统计数字。
- 若开发者组织被平台运营暂停,将不能新建条目、不能新建版本、不能修改上架信息、不能上架应用。
怎么打开
- 在浏览器中打开开放平台地址
https://dev.{base}/。页面外壳标题显示为「开放平台」。 - 首次进入时,由平台运营在运营台创建开发者组织并发出邀请后,你在登录页使用验证码点击「用验证码设置密码」完成初始化。
- 登录后通过侧栏导航进入各功能模块:
- 「快速开始」
- 「我的应用」分组:「应用」「API 凭证」「团队」
- 「文档」分组:「指南」「API 参考」「工具与 SDK」
- 「工具」分组:「Manifest 校验」「签名密钥」
- 「参考」分组:「契约等级」、App Bridge、「平台能力」
提示
- 若登录失败,整页显示「无法登录」,并提供链接「回到开放平台」。
- 登录后,运营台发布的公告横幅会展示在「应用」布局顶部。
界面一览
快速开始
用于指引开发者快速搭建应用或集成接口。
| 区域 / 模块 | 说明 |
|---|---|
| 页眉 | 显示「快速开始」。 |
| 「选择起点」 | 包含三张卡片(做应用、调 API、接 Agent 等路径),分别展示步骤、命令与预期输出(根据平台与 Agent 状态动态变化)。若无法读取平台信息,会说明命令中的令牌地址或权限范围为占位符。 |
| 「补充」 | 展示快速开始的关键补充要点。 |
| 「接下来」 | 包含三张导航卡片:「指南」「API 参考」「工具与 SDK」。 |
应用工作台
用于集中查看和管理本开发者组织的所有上架条目与版本进度。
| 区域 / 元素 | 说明 |
|---|---|
| 页眉与操作 | 显示「应用」与当前开发者组织名称,提供「创建」按钮。 |
| 「需要你处理」 | 待办事项区域: • 被驳回:标题含「被驳回」,操作按钮为「去修改」 • 已通过:标题含「已通过审核,等你上架」,操作按钮为「去上架」 • 检查失败:标题含「没有通过自动检查」 • 空状态:没有待办时显示「没有待办」。没有条目时提示「先创建你的第一个应用或数据模板。」;有条目但无待办时提示「没有被驳回的版本,也没有等你上架的版本。」 |
| 指标概览卡片 | 包含三张统计卡片:「条目」「总安装」「在审核中」。 |
| 「版本流水线」 | 阶段流程指示:草稿 / 待审核 / 审核中 / 已通过未上架 / 已上架 / 已驳回。 |
| 「我的条目」列表 | 包含以下列: • 「条目」:条目名称与标识 • 「类型」:条目类型(应用、数据模板、知识包、素材包) • 「上架版本」:当前在市场生效的版本号,未上架时显示「未上架」 • 「最新版本」:最新的版本号,尚未创建版本时显示「还没有版本」 • 「安装」:租户安装数量,显示数字后跟「 个租户」 • 空状态:列表中没有条目时显示「还没有条目」 |
创建上架条目
点击应用工作台的「创建」按钮打开弹窗。弹窗标题显示「创建上架条目」,提示「ID 创建后不能修改。」。
| 字段 | 必填 | 说明 |
|---|---|---|
| 「类型」 | 是 | 选择条目类型: • 应用:「应用:有自己的界面和能力,由你部署。」 • 模板:「数据模板:一组对象类型,安装后归租户修改。」 • 知识包:「知识包:一组文档,租户可搜索,Agent 也能用。」 • 素材:「素材包:一组提示词和技能。」 (未开放类型会标「(即将支持)」,当前四类均已开放) |
| 「名称」 | 是 | 条目名称,最长 80 个字符。占位提示「例如:康复诊所管理」 |
| 「ID」 | 是 | 唯一标识,规则为「3 到 48 位,小写字母、数字和 -,以字母开头;全平台唯一。」。保留词 admin、api、app、apps、ops、dev 等不可用。若 ID 已被占用提示「这个应用 ID 已被占用,应用 ID 全平台唯一」 |
| 「依赖的应用」 | 条件必填 | 仅在非应用类型(模板、知识包、素材)时显示,提示「租户须先安装该应用。」 |
| 「一句话介绍」 | 否 | 简短介绍,最多 200 字 |
条目全貌
点击具体条目后进入详情页。顶部提供返回「应用」的链接,展示条目类型徽章、当前上架版本(显示为具体版本号或「未上架」),右上角提供「新建版本」按钮。
| 标签页 | 包含内容与说明 |
|---|---|
| 「概览」 | • 统计卡片:显示安装数、启用中数量、版本数 • 「版本采用情况」:无安装时显示「还没有租户安装」,或提示「安装统计暂时不可用」 • 托管运行卡片与网关用量卡片 • 「上架清单」:包含五项步骤进度(写好上架信息 / 上传第一个版本 / 通过自动检查并提交审核 / 审核通过 / 上架) • 「基本信息」:显示应用 ID、类型、依赖、上架版本、平台实测契约等级(如 L0–L3) |
| 「版本」 | 显示版本数量。每个版本以卡片展示版本号与状态(草稿 / 排队等待审核 / 审核中 / 已通过,待上架 / 已驳回 / 已上架 / 已撤回)。展示下一步操作短句提示与自动检查摘要。 • 草稿状态提供「编辑」「提交审核」 • 已通过状态提供「上架」 • 提交审核弹窗提示「提交后内容固定、不能再改;不通过时请新建版本。」 • 上架弹窗提示「上架后租户可安装;开启自动升级的租户会立刻升级。」(若有自动升级租户,提示信息中带升级租户数) |
| 「评价」 | • 顶部显示评分均分与星级 • 提示「评价匿名,可回复、不能删除;违规评价请联系平台运营隐藏。」 • 提供「回复」或「修改回复」操作,回复内容最多 1000 字,提交后显示「你的回复」 • 没有评价时显示「还没有评价」 |
| 「上架信息」 | 维护对外展示信息: • 「名称」:条目名称 • 「分类」:所属分类 • 「一句话介绍」:简述 • 「详细介绍」:富文本说明 • 「截图」:每行一个 https 地址,最多 6 张,第一张作为封面图 • 点击「保存」后提示「上架信息已保存」 |
| 「模块」 | 当条目包含模块时展示,列出模块名称、说明与模块 ID |
新建与编辑版本
新建版本时标题为「新建版本」,提示「版本号必须比已有版本都高,如 1.0.1。保存后是草稿。」;编辑草稿时标题显示版本号,提示「版本号不能改;提交审核后内容冻结。」。
| 配置项 | 说明 |
|---|---|
| 配置正文 | 在线编辑配置文件(manifest.json 或数据模板/知识包/素材的配置 JSON),系统提供即时结构检查。 |
| 联邦版本提示 | 针对联邦类型应用,提示「联邦版本需先保存为草稿,再编辑草稿上传构建。」。 |
| 托管版本提示 | 针对托管类型应用,在配置中指定运行镜像(镜像格式为 名称@sha256:…),提示「托管运行时开发者看不到进程输出。」。 |
| 「版本说明」 | 填写更新日志与说明,最长 4000 个字符。 |
| 操作按钮 | 新建版本时显示「创建草稿」,编辑草稿时显示「保存草稿」。 |
API 凭证
用于管理访问开放平台接口与命令行工具(k3)的服务账号凭证。
| 区域 / 元素 | 说明 |
|---|---|
| 页眉与操作 | 显示「API 凭证」,提供「创建凭证」按钮(达到配额上限时该按钮禁用)。 |
| 凭证列表 | 包含以下列: • 名称与使用者标识(userId) • 状态:显示「可用」「已停用」或「待激活」 • 角色:固定为开发者服务角色 |
| 行操作 | 管理员下拉菜单提供「轮换密钥」「删除」。非管理员查看时提示「你只能查看」,说明创建、轮换和删除凭证需要管理员角色。 |
| 提示与说明 | • 页脚提示「列表里没有密钥,也没有 client id:它们只在创建或轮换时显示一次。」 • 达到上限时提示「已经到上限,需要先删除一个不用的。」 • 没有凭证时显示「还没有 API 凭证」 • 「怎么用」:说明支持通过 k3 命令行工具登录或自行换取令牌。API 凭证是仅持有开发者权限的服务账号 |
| 创建弹窗 | 标题「创建 API 凭证」,提示「创建后密钥只显示一次。」。名称规则为「2–63 位,小写字母、数字、- 或 _,以字母开头,例如 ci-release」。 |
| 密钥展示弹窗 | 对话框不可点击外部关闭,顶部警示「密钥只显示这一次」。展示 Client ID 与 Client Secret,提供「命令行登录」「换令牌(curl)」与 CI 环境变量说明。必须勾选「我已经把密钥保存好了」才可点击「我已保存」关闭窗口。 |
| 轮换与删除 | • 轮换:旧密钥立刻失效,新密钥只显示一次 • 删除:提示「用它登录的 CI 和 k3 立刻失效,已签发的令牌几分钟内过期。不能撤销。」 |
团队
用于管理开发者组织内部的成员及其角色权限。
| 区域 / 元素 | 说明 |
|---|---|
| 顶部操作 | 提供「邀请成员」按钮。非管理员访问提示「只有管理员可以邀请成员或调整角色。」。 |
| 成员列表 | 显示姓名与邮箱。状态标记包含「你」(当前用户)、「待激活」、「已停用」。角色下拉菜单包含「开发者」「管理员」。 |
| 行操作 | 管理员可执行「重发邀请」「重置密码」「停用」「重新启用」。不能停用自己,不能移除最后一位管理员。 |
| 角色说明 | • 开发者:「创建条目、上传版本、提交审核、上架。每个成员都有。」 • 管理员:「另外可以邀请成员、调整角色、停用成员。」 |
| 邀请弹窗 | 输入成员邮箱,可选勾选「同时设为管理员」。提交后若当场生成验证码,提示「只显示这一次。」。 |
| 停用确认 | 确认弹窗说明「对方不能再登录;已提交的版本和上架的条目不受影响,可随时重新启用。」。 |
API 参考与 Try it
| 模块 | 说明 |
|---|---|
| 「API 参考」 | 由平台接口规范自动生成,包含「分组」与「共享约定」(认证、错误、状态码、列表、重试、时间、版本)。窄屏下展示「接口列表」。 |
| 接口参数与 Try it | 展示接口参数表与 Try it 在线调试面板。 |
| Try it 状态提示 | • 未登录:提示「登录后可以试一试」「发送请求需要登录;上面的示例可直接复制。」 • 已登录:提示「这是真实调用」,说明请求会带着当前令牌发送至服务端,读写真实数据,写入和删除操作不可撤销。调用非安全方法时弹出二次确认「发送这个真实请求?」 • 运营与内部接口限制:若在开发者门户调用运营或内部接口,提示「这个站点调不到它」「运营接口只在运营网的监听器上提供。」或「这是内部接口,只在内部网络上提供。」,「发送请求」按钮处于禁用状态 |
| 执行结果 | 点击「发送请求」后,展示响应状态码、耗时、X-Request-Id 请求标识、响应头与响应体。 |
Manifest 校验
用于在提交注册前验证配置文件的结构合法性。
- 界面提示「粘贴 manifest.json 做结构检查。内容不会上传。」。
- 提供「载入模板示例」按钮。
- 校验结果:结构通过显示「结构检查通过」;发现问题时显示发现的具体问题数量并提示「修复后再提交注册。」,同时可能给出契约等级调整建议。
其它公开页面
- 「工具与 SDK」:提供一条命令安装 k3 命令行工具、下载表格、命令速查以及 SDK 现状。若部署环境未内置命令行工具,提示「这个部署没有内置命令行」。
- 「签名密钥」:提供 JWKS 公钥地址(
{origin}/.well-known/k3-jwks.json)。若平台未开启签名控制模块,提示「平台尚未启用 Draft 服务(k3-control 模块)。」。 - 「契约等级」:展示 L0 至 L3 契约等级标准与规范要求列表。
- App Bridge、「平台能力」与「指南」:开发者文档页面。其中「指南」分为「基础」「开发应用」「集成」三个分组。
常用操作
从零上架一个应用
- 打开开放平台地址
https://dev.{base}/,点击顶栏「登录」。首次登录时在登录页使用验证码点击「用验证码设置密码」完成初始化后登录。 - 在左侧导航点击「我的应用」下的「应用」,点击页面右上角「创建」。
- 在「创建上架条目」弹窗中填写条目基础信息:
字段 必填 说明 「类型」 是 选择「应用:有自己的界面和能力,由你部署。」 「名称」 是 应用名称,最长 80 个字符。占位提示「例如:康复诊所管理」 「ID」 是 唯一标识,3 到 48 位,以字母开头,仅允许小写字母、数字和连字符「-」。全平台唯一,创建后不能修改。不能使用保留词 「一句话介绍」 否 简短描述,最多 200 字 - 点击「创建」。创建完成后自动进入条目全貌页。
- 切换到「上架信息」标签,完善市场资料:
字段 必填 说明 「名称」 是 条目对外展示名称 「分类」 是 选择业务分类 「一句话介绍」 是 一句话功能描述 「详细介绍」 是 详细功能与使用说明 「截图」 否 每行填写一个 https 图片地址,最多 6 张,第一张作为封面图 - 点击「保存」,系统提示「上架信息已保存」。
- 点击右上角「新建版本」,在弹窗中填写版本信息:
- 输入版本号(提示「版本号必须比已有版本都高,如 1.0.1。保存后是草稿。」)。
- 编写 manifest.json 内容,核对即时结构检查结果。
- 填写「版本说明」(最长 4000 个字符)。
- 点击「创建草稿」。
- 切换到「版本」标签,在草稿版本卡片上点击「提交审核」。
- 在确认弹窗中确认(弹窗提示「提交后内容固定、不能再改;不通过时请新建版本。」)。系统执行自动检查,检查全部通过后状态转为「排队等待审核」(若检查失败则保留在草稿,须修改后重新提交)。
- 等待平台运营审核。审核人员接手后状态变为「审核中」,审核通过后状态变为「已通过,待上架」。
- 在版本卡片上点击「上架」,在确认弹窗中确认(弹窗提示「上架后租户可安装;开启自动升级的租户会立刻升级。」)。确认后版本状态变为「已上架」,租户即可在组织应用市场中安装。
注意
若版本被运营驳回,该版本属于终态不可再修改。须点击「新建版本」填写更高的版本号,根据驳回原因修改配置后重新提交审核。
创建 API 凭证
- 在左侧导航点击「我的应用」下的「API 凭证」(须具备管理员角色)。
- 点击右上角「创建凭证」(若已达上限,该按钮处于禁用状态)。
- 填写凭证名称:
字段 必填 说明 「名称」 是 2–63 位,以字母开头,仅允许小写字母、数字、连字符「-」或下划线「_」,例如 ci-release - 点击「创建」。
- 系统弹出密钥展示窗口(提示「密钥只显示这一次」),复制记录 Client ID 与 Client Secret。
- 勾选「我已经把密钥保存好了」复选框,点击「我已保存」关闭窗口。
- 在开发环境或 CI 中使用凭证:通过
k3 login登录,或配置环境变量K3_URL、K3_CLIENT_ID、K3_CLIENT_SECRET,通过k3 publish --wait发布版本。
危险
凭证密钥仅在创建或轮换时展示一次,列表不会保存密钥明文。关闭窗口前必须妥善复制保存。
轮换与删除 API 凭证
- 在左侧导航点击「我的应用」下的「API 凭证」。
- 轮换密钥:
- 在列表中找到目标凭证,点击右侧操作菜单,选择「轮换密钥」。
- 确认轮换后旧密钥立刻失效,窗口中展示新密钥(只显示这一次)。
- 妥善复制保存新密钥,勾选确认后关闭窗口。
- 删除凭证:
- 在列表中找到目标凭证,点击右侧操作菜单,选择「删除」。
- 弹窗提示「用它登录的 CI 和 k3 立刻失效,已签发的令牌几分钟内过期。不能撤销。」。
- 确认后凭证被永久删除。
邀请团队成员与管理角色
- 在左侧导航点击「我的应用」下的「团队」(须具备管理员角色)。
- 点击右上角「邀请成员」。
- 填写成员邮箱;若需要管理员权限,勾选「同时设为管理员」。
- 点击确认发送邀请。若界面当场生成验证码,提示「只显示这一次。」,须妥善记录并告知被邀请人。
- 调整角色:在成员列表中找到对应成员,在「角色」下拉菜单中切换「开发者」或「管理员」。
停用与重新启用成员
- 在左侧导航点击「我的应用」下的「团队」。
- 停用成员:在目标成员右侧点击「停用」,弹窗提示「对方不能再登录;已提交的版本和上架的条目不受影响,可随时重新启用。」,确认后成员状态变更为「已停用」(不能停用自己,也不能移除最后一位管理员)。
- 重新启用:在状态为「已停用」的成员右侧点击「重新启用」,恢复该成员的操作权限。
校验 Manifest 配置文件
- 在左侧导航点击「工具」下的「Manifest 校验」。
- 在编辑区域粘贴 manifest.json 内容(也可点击「载入模板示例」载入参考配置)。
- 查看校验结果:
- 结构合法:显示「结构检查通过」。
- 存在问题:显示问题数量并提示「修复后再提交注册。」,根据系统提示修正后再提交。
在线调试 API(Try it)
- 在左侧导航点击「文档」下的「API 参考」。
- 在接口列表中点击目标接口,进入操作详情页。
- 确认已登录开发者账号(未登录时提示「登录后可以试一试」「发送请求需要登录;上面的示例可直接复制。」)。
- 在 Try it 调试面板中填写请求参数。
- 点击「发送请求」。若涉及写操作或删除操作,在二次确认弹窗「发送这个真实请求?」中确认。
- 查看接口返回的 HTTP 状态码、耗时、X-Request-Id 请求标识、响应头与响应体。
注意
Try it 是真实调用,请求会携带你的开发者身份令牌发往服务端,读写真实数据,写入与删除操作不可撤销。运营网络与内部网络接口在此站点无法调用。
回复用户评价
- 在左侧导航点击「我的应用」下的「应用」,点击目标条目进入详情页。
- 切换到「评价」标签。
- 查看用户提交的评分与匿名评价内容。
- 在目标评价下方点击「回复」(若已回复过可点击「修改回复」)。
- 输入回复内容(最多 1000 个字符),点击提交。提交后该评价下方显示「你的回复」。
状态说明
版本状态
| 状态 | 说明 | 转换操作 |
|---|---|---|
| 「草稿」 | 版本正在编辑,尚未提交;或提交时未通过自动检查 | 点击「编辑」修改内容;点击「提交审核」提交 |
| 「排队等待审核」 | 自动检查全部通过,已提交平台等待运营审核 | 等待运营人员接手审核 |
| 「审核中」 | 平台运营人员正在对该版本进行审核 | 等待审核结论 |
| 「已通过,待上架」 | 平台审核已通过,尚未在市场上架 | 点击「上架」正式发布 |
| 「已上架」 | 版本已正式上架,租户可在应用市场安装 | 平台运营可在管理端撤回 |
| 「已驳回」 | 审核未通过,属于终态,不可再修改 | 须新建更高版本号重新提交 |
| 「已撤回」 | 已上架版本被平台运营撤回下架 | 终态 |
状态流转过程: 草稿 → 排队等待审核 → 审核中 → 已通过,待上架 → 已上架 (提交时自动检查失败停留在「草稿」;审核未通过转为「已驳回」;已上架版本可被运营「已撤回」)
API 凭证状态
| 状态 | 说明 |
|---|---|
| 「可用」 | 凭证处于激活可用状态,可用于接口调用与命令行工具认证 |
| 「待激活」 | 凭证已生成,等待初始化激活 |
| 「已停用」 | 凭证已被禁用,无法用于身份鉴权 |
团队成员状态
| 状态 | 说明 |
|---|---|
| 正常(无标记) | 成员已激活,可正常登录系统与协同开发 |
| 「待激活」 | 邀请已发出,成员尚未设置密码激活账号 |
| 「已停用」 | 成员已被管理员停用,不能再登录系统;已提交的版本不受影响 |
让助手帮你做
开放平台本身不是租户应用,不向工作台助手(Agent)暴露运营或开发者操作接口,门户内不提供助手对话功能。条目创建、版本上传、审核提交、凭证管理与团队维护均须在开放平台界面中手动操作(开发者构建的应用在租户端可向租户声明可起草的操作,属于租户侧功能)。
设置
开放平台无门户级全局设置项,各组织可在对应模块中维护以下配置:
| 模块 | 设置项 | 规则与取值 | 说明 |
|---|---|---|---|
| 上架条目 | 「上架信息」 | 名称、分类、一句话介绍(最多 200 字)、详细介绍、截图(最多 6 张 https 地址) | 决定应用在应用市场的展示资料,第一张截图作为封面图 |
| API 凭证 | 「名称」 | 2–63 位,以字母开头,仅包含小写字母、数字、-、_ | 标识服务账号用途,如 ci-release |
| 团队 | 「角色」 | 「开发者」「管理员」 | 决定成员在开发者组织内的管理权限 |
注意事项
- 应用 ID 规则与全平台唯一:应用 ID 全平台唯一,长度为 3 到 48 位,以字母开头,仅允许小写字母、数字和连字符「-」。创建后不可修改,且不可使用 admin、api、app、apps、ops、dev 等系统保留词。
- 版本号单调递增与内容冻结:新建版本的版本号必须高于已有所有版本(如 1.0.1)。一旦点击「提交审核」,版本内容即刻冻结不可修改。
- 驳回版本不可修改:版本被驳回后属于终态,不能在原版本上修改或重新提交,必须新建一个更高版本号的版本重新提交。
- 审核通过不等于上架:审核通过后的状态为「已通过,待上架」,必须由开发者在版本卡片上手动点击「上架」并确认后,租户方可在组织应用市场中安装。
- 不可靠低版本回滚:无法通过上架更低版本号的方式进行版本回滚。
- 上架联动自动升级:上架新版本后,所有在组织中开启了自动升级的租户会立刻自动升级到新版本。
- 密钥只显示一次与轮换即时失效:API 凭证的 Client ID 与 Client Secret 仅在创建或轮换时展示一次,列表不会保存密钥明文。轮换会使旧密钥立刻失效;删除凭证会导致使用它的 CI 与命令行工具立刻失效,已签发令牌数分钟内过期,且删除不可撤销。
- 凭证权限范围:API 凭证是仅持有开发者权限(
isv.developer)的服务账号,不能用于管理组织成员或执行管理员写操作;创建、轮换与删除凭证需要管理员角色(isv.admin)。 - 评价不可删除:用户评价匿名展示(不包含租户 ID),开发者可回复或修改回复(最多 1000 字),但不能自行删除评价;如遇违规评价须联系平台运营处理隐藏。
- 严格数据隔离:开发者无法查看其他 ISV 的任何数据,也无法查看任何租户的业务数据与身份信息;安装量仅显示聚合统计数字;访问其他开发者的应用时页面提示找不到。
- 组织暂停限制:若开发者组织被平台运营暂停,将无法新建条目、无法新建版本、无法修改上架信息、无法上架应用。
- 特殊构建类型限制:
- 联邦版本须先在控制台保存为草稿,再编辑草稿上传构建。
- 托管运行镜像须指定带校验码的镜像名称(
名称@sha256:…),且托管运行时开发者无法查看进程输出。
- Try it 真实调用风险:Try it 调试会携带当前登录者的真实令牌向平台发起实际请求,读写真实数据,写入与删除操作不可撤销;运营网与内部网络接口在开放平台站点无法调用。
目前不支持
- 开发者收入与结算页面(当前无收入、结算与分账管理功能)。
- 在开放平台直接调试运营接口与内部接口(运营接口仅在运营网络提供,内部接口仅在内部网络提供,开放平台禁止发送调试请求)。
常见问题
审核通过后,租户可以直接在应用市场安装了吗?
不能。审核通过后的状态为「已通过,待上架」,此时市场中尚不提供该版本安装。必须由开发者在版本卡片上手动点击「上架」并在弹窗中确认后,版本状态变为「已上架」,租户方可在组织应用市场中看到并安装;开启了自动升级的租户会在此刻自动升级。
版本被运营审核驳回后,可以直接修改原版本再次提交吗?
不能。版本一旦提交审核,配置内容即刻冻结;审核被驳回属于终态。你需要点击右上角「新建版本」,输入比已有版本更高的版本号(例如原版本为 1.0.0,新建 1.0.1),根据驳回原因修改配置内容后重新提交审核。
API 凭证创建后忘记保存 Client Secret,还能再次查看吗?
不能。API 凭证的密钥在创建和轮换时仅展示一次,列表中不会保存或显示密钥明文。如果遗失,需要管理员在凭证列表中点击「轮换密钥」,旧密钥会立刻失效并重新生成一套新的 Client ID 与 Client Secret,请在弹出窗口中妥善复制并保存。
登录后提示「这个账号不属于任何开发者组织」该如何处理?
开放平台的应用工作台、API 凭证与团队管理功能仅对加入了开发者组织的账号开放。出现此提示说明你的账号尚未加入任何开发者组织,请联系平台运营在运营台中创建开发者组织并向你发出邀请。
在 API 参考中使用 Try it 发送请求是模拟测试吗?
不是。Try it 是真实调用,会携带你当前登录账号的真实令牌向平台接口发起网络请求,读取和修改真实数据。涉及写入和删除的操作无法撤销,请谨慎操作。