Referensi API HappyOyster-Acting-Pause Travel

​

Cakupan

• Autentikasi: Kunci API utama tidak wajib; kunci API utama atau sementara dapat digunakan untuk memanggilnya. Untuk cara mendapatkannya, lihat Mendapatkan kredensial autentikasi.
• Prasyarat: Status Travel harus running. Konfirmasikan melalui Query Travel Status.
• Pemanggil: Server atau klien Anda dapat memanggilnya.

​

Permintaan HTTP

curl --location 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v2/apps/happyoyster-1.0-acting/openapi/v1/travels/pause' \
    -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
    -H 'Content-Type: application/json' \
    -d '{
    "encryptedTravelId": "{encryptedTravelId}",
    "userAgent": "HappyOyster-Web/1.2.0"
}'

{
    "code": 0,
    "message": null,
    "data": {
        "encryptedTravelId": "trvl_a1b2****",
        "status": "paused"
    }
}

​

Status prasyarat dan catatan pemanggilan

• Status Travel saat ini harus running.
• version dalam respons enter-room harus bernilai actingV2; memasuki ruang untuk Acting selalu mengembalikan nilai ini.
• Konfirmasi jeda adalah proses asinkron. Setelah menerima respons sukses, jika Anda perlu segera melanjutkan atau mengirim operasi yang bergantung pada status terjeda, lanjutkan polling Query Travel Status hingga status yang dikueri adalah paused.
• Konfirmasi jeda biasanya memiliki hambatan status sekitar 3 detik; status aktual bergantung pada hasil kueri.
• Menjeda tidak mengubah aspectRatio; klien mempertahankan orientasi pemutar yang ditentukan pada saat memasuki ruang.

​

Kode kesalahan

​

Langkah selanjutnya

• Resume Travel: lanjutkan Travel yang dijeda dan teruskan pembuatan.
• Send Process Instruction: mengirim instruksi dalam status paused hanya menerima instruksi tersebut dan tidak secara otomatis melanjutkan.
• End Travel: akhiri Travel secara langsung.