Referensi API HappyOyster-Directing-Send Process Instruction

​

Cakupan

• Autentikasi: Kunci API utama tidak wajib; kunci API utama atau sementara dapat digunakan untuk memanggilnya. Untuk cara mendapatkannya, lihat Mendapatkan kredensial autentikasi.
• Prasyarat: creationModel Travel harus simple, dan harus dalam status yang dapat menerima instruksi. Konfirmasi 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-directing/openapi/v1/travels/instruct' \
    -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
    -H 'Content-Type: application/json' \
    -d '{
    "encryptedTravelId": "{encryptedTravelId}",
    "content": "A giant robot dinosaur suddenly appears",
    "clientRequestId": "instruction_20260909_001",
    "userAgent": "your-client/1.2.0"
}'

{
    "code": 0,
    "message": null,
    "data": {
        "encryptedTravelId": "trvl_a1b2****",
        "content": "A giant robot dinosaur suddenly appears",
        "accepted": true
    }
}

​

Status prasyarat dan catatan pemanggilan

• Hanya creationModel=simple yang mendukung endpoint ini; Travel scriptlist harus menggunakan Full Script Update, dan memanggil instruct secara keliru akan mengembalikan 403006.
• Status Travel saat ini harus dapat menerima instruksi; Travel yang telah berakhir atau gagal tidak dapat ditulis.
• Ketika content kosong atau melebihi 2000 karakter, 400000 dikembalikan.
• Sebaiknya buat clientRequestId yang stabil untuk setiap instruksi logis dan gunakan kembali saat mencoba ulang.
• Jika instruksi gagal melewati kebijakan keamanan konten, 403004 akan dikembalikan.

​

Kode kesalahan

​

Langkah selanjutnya

• Query Travel Status: lihat status eksekusi instruksi dan informasi bab.
• Pause Travel / Resume Travel / Rewind Travel.
• End Travel: akhiri sesi dan proses artefak.