Todos los productos
Search

Este producto

    Alibaba Cloud Model Studio:Referencia de la API HappyOyster-Acting-Delete World

    Centro de documentos

    Alibaba Cloud Model Studio:Referencia de la API HappyOyster-Acting-Delete World

    Última actualización: Oct 12, 2026

    Elimina un mundo de Acting bajo la cuenta principal actual. Cuando el mundo ya no existe bajo la misma cuenta, devuelve deleted=false de forma idempotente.

    Ámbito

    Eliminar un mundo de Acting bajo la cuenta principal actual. Antes de realizar la llamada, confirme lo siguiente:

    • Autenticación: Solo se admite la API Key principal; no se pueden utilizar API Keys temporales (código de error 403003).

    • Requisitos previos: Eliminar con el encryptedWorldId devuelto por Crear Mundo.

    • Solicitante: Llamado por su servidor. Este endpoint no acepta el campo del cuerpo de solicitud userAgent.

    Solicitud HTTP

    Singapore

    POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v2/apps/happyoyster-1.0-acting/openapi/v1/worlds/delete

    Reemplace {WorkspaceId} con su ID de espacio de trabajo real.

    EE. UU. (Virginia)

    POST https://{WorkspaceId}.us-east-1.maas.aliyuncs.com/api/v2/apps/happyoyster-1.0-acting/openapi/v1/worlds/delete

    Reemplace {WorkspaceId} con su ID de espacio de trabajo real.

    Parámetros de solicitud

    Eliminar mundo

    curl --location 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v2/apps/happyoyster-1.0-acting/openapi/v1/worlds/delete' \
    -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
    -H 'Content-Type: application/json' \
    -d '{
    "encryptedWorldId": "{encryptedWorldId}"
}'

    Content-Typestring(Requerido)

    Tipo de contenido de la solicitud. Este parámetro debe establecerse en application/json.

    Authorization string (Requerido)

    Autenticación mediante API Key. Solo se admite la API Key principal; comienza con sk-, p. ej., sk-xxx. Normalmente se configura como la variable de entorno $DASHSCOPE_API_KEY. Una API Key temporal (que comienza con st-) devuelve 403003.

    Cuerpo de la solicitud

    encryptedWorldId string (Requerido)

    El ID de mundo cifrado de Acting a eliminar. Devuelto por Crear Mundo.

    Parámetros de respuesta

    Eliminado correctamente

    {
    "code": 0,
    "message": null,
    "data": {
        "encryptedWorldId": "enc_a1b2****",
        "deleted": true
    }
}

    El mundo ya no existe

    {
    "code": 0,
    "message": null,
    "data": {
        "encryptedWorldId": "enc_a1b2****",
        "deleted": false
    }
}

    code integer

    Código de retorno. 0 indica éxito; un valor distinto de cero es un código de error.

    message string

    Mensaje de error. null en caso de éxito.

    data object

    Datos de respuesta. null en caso de fallo.

    Propiedades

    encryptedWorldId string

    El ID de mundo cifrado de la solicitud.

    deleted boolean

    true significa que fue eliminado; false significa que no se eliminó ningún mundo esta vez.

    Estados previos y notas de llamada

    • Cuando el mundo ya no existe bajo la misma cuenta, devuelve code=0 y deleted=false, no 403001.
    • Cuando el ID es analizable pero cruza cuentas, no coincide con el espacio de trabajo o el recurso no es un mundo de Acting, se devuelve 403001.
    • Después de la eliminación, las llamadas subsiguientes de detalle, estado de construcción o intercambio de credenciales se manejan como un recurso inexistente.
    • Un ticket emitido pero no utilizado no debe tratarse como una referencia válida a largo plazo; la disponibilidad del mundo se vuelve a validar al entrar en la sala.

    Códigos de error

    Si la llamada al modelo falla y devuelve un error, consulte Códigos de error de HappyOyster para resolverlo.

    Siguientes pasos