删除当前主账号名下的 Acting World。同账号下 World 已不存在时幂等返回 deleted=false。
适用范围
删除当前主账号名下的 Acting World。调用前请确认以下事项：
-
鉴权要求：仅支持主 API Key调用，临时 API Key 不可用（错误码
403003）。- 获取主 API Key：获取与配置 API Key。
-
前置条件：使用创建World接口返回的
encryptedWorldId删除。 -
调用方：您的服务端调用。本接口不接受请求体字段
userAgent。
HTTP调用
- 新加坡
- 美国（弗吉尼亚）
POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v2/apps/happyoyster-1.0-acting/openapi/v1/worlds/delete调用时请将{WorkspaceId}替换为真实的Workspace ID。请求参数 |
|
Content-Typestring（必选）请求内容类型。此参数必须设置为application/json。 | |
Authorization string （必选）API Key 鉴权。仅支持主 API Key，以 sk- 开头，如 sk-xxx。通常配置为环境变量 $DASHSCOPE_API_KEY。临时 API Key（st- 开头）调用返回 403003。 | |
请求体（Request Body） | |
encryptedWorldId string （必选）要删除的 Acting 加密 World ID。由创建World接口返回。 |
响应参数 |
|
code integer返回码。0 表示成功，非 0 为错误码。 | |
message string错误信息。成功时为 null。 | |
data object响应数据。失败时为 null。
属性 encryptedWorldId string请求中的加密 World ID。deleted booleantrue 表示已删除；false 表示本次未删除到 World。 |
前置状态与调用注意事项
- 同账号下 World 已不存在时返回
code=0且deleted=false，不返回403001。 - ID 可解析但跨账号、workspace 不匹配或资源不是 Acting World 时，返回
403001。 - 删除后继续调用详情、构建状态或换凭证会按资源不存在处理。
- 已经签发但尚未使用的 ticket 不应被视为长期有效引用；进房时仍会重新校验 World 可用状态。