Referensi API HappyOyster-Adventure-Get Travel Credential

​

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: World harus milik akun utama saat ini dan model Adventure, serta statusnya harus ready. Konfirmasikan melalui Kueri Status Pembangunan World.
• Pemanggil: Dipanggil oleh server Anda; ticket yang dihasilkan sebaiknya hanya diberikan kepada klien yang akan segera masuk ke room.

​

Permintaan HTTP

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

{
    "code": 0,
    "message": null,
    "data": {
        "ticket": "tk_a1b2****",
        "expiresIn": 1800,
        "encryptedWorldId": "enc_a1b2****"
    }
}

​

Status prasyarat dan catatan pemanggilan

• World harus berstatus ready.
• ticket berlaku selama 30 menit dan hanya dapat berhasil digunakan satu kali; dapatkan yang baru setelah kedaluwarsa atau telah digunakan.
• ticket sebaiknya hanya diberikan kepada klien yang akan segera masuk ke room, dan tidak boleh disimpan sebagai kredensial akses jangka panjang.
• Memanggil endpoint ini tidak membuat Travel; Travel dibuat ketika proses masuk ke room berhasil.
• Jika kuota untuk World ini belum dibeli, maka 403007 akan dikembalikan; jika konfigurasi kapasitas sementara tidak tersedia, maka 403008 akan dikembalikan.

​

Kode kesalahan

​

Langkah selanjutnya

• Masuk Travel: klien menggunakan ticket untuk membuat Travel dan mendapatkan konfigurasi RTC.