Referensi API HappyOyster-Acting-Delete World

​

Cakupan

• Autentikasi: Hanya API Key utama yang didukung; API Key sementara tidak dapat digunakan (kode kesalahan 403003).
  • Dapatkan API Key utama: Mendapatkan dan mengonfigurasi API Key.
• Prasyarat: Hapus dengan encryptedWorldId yang dikembalikan oleh Buat Dunia.
• Pemanggil: Dipanggil oleh server Anda. Endpoint ini tidak menerima field request body userAgent.

​

Permintaan HTTP

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}"
}'

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

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

​

Status prasyarat dan catatan pemanggilan

• Ketika World tidak lagi ada di bawah akun yang sama, sistem mengembalikan code=0 dan deleted=false, bukan 403001.
• Jika ID dapat diurai tetapi lintas akun, tidak cocok dengan workspace, atau sumber daya bukan merupakan Acting World, maka 403001 akan dikembalikan.
• Setelah penghapusan, panggilan detail, status pembangunan, atau penukaran kredensial selanjutnya akan ditangani sebagai sumber daya yang tidak ada.
• Tiket yang telah diterbitkan namun belum digunakan tidak boleh dianggap sebagai referensi yang valid jangka panjang; ketersediaan World tetap divalidasi ulang saat memasuki ruangan.

​

Kode kesalahan

​

Langkah selanjutnya

• Query World List: lihat Acting World yang tersisa.
• Create World: buat Acting World baru.