Supprimer un monde de mise en scène sous le compte principal actuel. Lorsque le monde n'existe plus sous le même compte, l'opération retourne deleted=false de manière idempotente.
Scope
Supprimer un monde de mise en scène sous le compte principal actuel. Avant d'effectuer l'appel, confirmer les points suivants :
-
Authentification : Seule la clé API principale est prise en charge ; les clés API temporaires ne peuvent pas être utilisées (code d'erreur
403003).- Obtenir la clé API principale : Obtenir et configurer une clé API.
-
Prérequis : Supprimer avec l'
encryptedWorldIdretourné par Créer un monde. -
Appelant : Appelé par votre serveur. Ce point de terminaison n'accepte pas le champ de corps de requête
userAgent.
Requête HTTP
- Singapore
- États-Unis (Virginie)
POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v2/apps/happyoyster-1.0-directing/openapi/v1/worlds/deleteRemplacez {WorkspaceId} par votre véritable ID d'espace de travail.Paramètres de la requête |
|
Content-Typestring(Requis)Type de contenu de la requête. Ce paramètre doit être défini sur application/json. | |
Authorization string (Requis)Authentification par clé API. Seule la clé API principale est prise en charge ; elle commence par sk-, par ex. sk-xxx. Elle est généralement configurée comme variable d'environnement $DASHSCOPE_API_KEY. Une clé API temporaire (commençant par st-) renvoie 403003. | |
Corps de la requête | |
encryptedWorldId string (Requis)L'ID de monde chiffré de mise en scène à supprimer. Retourné par Créer un monde. |
Paramètres de réponse |
|
code integerCode de retour. 0 indique un succès ; une valeur non nulle correspond à un code d'erreur. | |
message stringMessage d'erreur. null en cas de succès. | |
data objectDonnées de réponse. null en cas d'échec.
Propriétés encryptedWorldId stringL'ID de Monde chiffré provenant de la requête.deleted booleantrue signifie qu'il a été supprimé ; false signifie qu'aucun Monde n'a été supprimé cette fois-ci. |
États préalables et notes d'appel
- Lorsque le Monde n'existe plus sous le même compte, cela renvoie
code=0etdeleted=false, et non403001. - Lorsque l'ID est analysable mais appartient à un autre compte, ne correspond pas à l'espace de travail, ou que la ressource n'est pas un monde de mise en scène,
403001est retourné. - Après la suppression, les requêtes ultérieures sur ce monde sont traitées comme une ressource inexistante ou supprimée.
Codes d'erreur
Si l'appel du modèle échoue et renvoie une erreur, consultez Codes d'erreur HappyOyster pour la résoudre.
Étapes suivantes
- Interroger la liste des mondes : consulter les mondes de mise en scène restants.
- Créer un monde : créer un nouveau monde de mise en scène.