Skip to main content
Referensi Open API Adventure

Referensi API HappyOyster-Adventure-Query Travel List

Melakukan paginasi pada Adventure Travels di bawah akun utama saat ini, dengan pemfilteran opsional berdasarkan status atau World yang terkait.

Cakupan

Lakukan paginasi pada Adventure Travel di bawah akun utama saat ini, dengan pemfilteran opsional berdasarkan status atau World terkait. Sebelum memanggil, pastikan hal berikut:
  • Autentikasi: Hanya API Key utama yang didukung; API Key sementara tidak dapat digunakan (kode kesalahan 403003).
  • Pemanggil: Dipanggil oleh server Anda.

Permintaan HTTP

  • Singapore
  • Tiongkok (Beijing)
  • AS (Virginia)
GET https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v2/apps/happyoyster-1.0-adventure/openapi/v1/travelsGanti {WorkspaceId} dengan ID Workspace Anda yang sebenarnya.

Parameter permintaan

  • Kueri daftar Travel
curl --location 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v2/apps/happyoyster-1.0-adventure/openapi/v1/travels?page=1&pageSize=20&status=completed&encryptedWorldId={encryptedWorldId}' \
    -H "Authorization: Bearer $DASHSCOPE_API_KEY"
Authorization string (Wajib)Autentikasi API Key. Hanya API Key utama yang didukung; dimulai dengan sk-, misalnya sk-xxx. Biasanya dikonfigurasi sebagai variabel lingkungan $DASHSCOPE_API_KEY. API Key sementara (dimulai dengan st-) akan mengembalikan 403003.
Parameter kueri
page integer (Opsional)Nomor halaman, defaultnya 1. Jika page <= 0, nilainya dianggap sebagai 1.
pageSize integer (Opsional)Jumlah item per halaman, defaultnya 20. Jika pageSize <= 0, nilainya dianggap sebagai 20; jika lebih besar dari 100, nilainya dibatasi hingga 100.
status string (Opsional)Filter berdasarkan status Travel. Nilai yang tidak dikenal tidak diterapkan sebagai filter. Nilai yang diizinkan:
  • init: menginisialisasi sumber daya sesi
  • pending: dalam antrean atau menunggu sumber daya layanan
  • running: berjalan
  • failed: Travel gagal
  • completed: Travel telah berakhir; artifacts dapat dikueri
encryptedWorldId string (Opsional)ID Adventure World di bawah akun utama saat ini. Jika disediakan, hanya Travel dari World tersebut yang akan dikembalikan. Endpoint ini tidak mendukung parameter kueri mode; entri khusus model secara otomatis membatasi hasil ke Adventure.

Parameter respons

  • Kueri berhasil
{
    "code": 0,
    "message": null,
    "data": {
        "items": [
            {
                "encryptedTravelId": "trvl_a1b2****",
                "status": "completed",
                "mode": 1,
                "encryptedWorldId": "enc_a1b2****",
                "durationSec": 90,
                "createdAt": "2026-06-03T10:00:00Z",
                "endedAt": "2026-06-03T10:01:30Z"
            },
            {
                "encryptedTravelId": "trvl_g7h8****",
                "status": "running",
                "mode": 1,
                "encryptedWorldId": "enc_a1b2****",
                "durationSec": null,
                "createdAt": "2026-06-03T11:00:00Z",
                "endedAt": null
            }
        ],
        "pagination": {
            "page": 1,
            "pageSize": 20,
            "total": 2,
            "hasMore": false
        }
    }
}
code integerKode pengembalian. 0 berarti berhasil; bukan nol adalah kode kesalahan.
message stringPesan kesalahan. null jika berhasil.
data objectData respons. null jika gagal.

Properti

items arrayTravel pada halaman saat ini; berupa array kosong jika tidak ada hasil. Setiap item berisi encryptedTravelId, status, mode (selalu 1), encryptedWorldId, durationSec (null saat berjalan, gagal, atau durasi belum tersedia), createdAt, dan endedAt (null saat masih berjalan).pagination objectInformasi paginasi. Berisi page, pageSize, total, dan hasMore.

Status prasyarat dan catatan pemanggilan

  • Endpoint secara otomatis hanya mengembalikan Adventure Travel, dan items[].mode selalu 1.
  • Saat memfilter dengan encryptedWorldId, World tersebut harus milik akun utama saat ini dan model Adventure; World dari model lain akan mengembalikan 403001.
  • Untuk Travel yang sedang berjalan, durationSec dan endedAt biasanya bernilai null.
  • status yang tidak dikenal tidak menimbulkan kesalahan; hal ini diperlakukan sebagai tanpa filter status.
  • Hasil kosong bukanlah kesalahan; respons akan mengembalikan items=[] beserta informasi paginasi yang sesuai.

Kode kesalahan

Jika pemanggilan model gagal dan mengembalikan kesalahan, lihat Kode Kesalahan HappyOyster untuk menyelesaikannya.

Langkah selanjutnya

Penggunaan API
Generasi teks
Pembuatan Gambar
  • FAQ
Video Generation
Model Dunia
Audio
  • Pembuatan audio
Real-time multimodal
Realtime API
Penyematan Teks
Lainnya Model
Toolkit/Framework
TokenPlan
Model production
Manajemen file
Penagihan
Manajemen Model
Lebih Banyak Tentang Model