Tous les produits
Search
Centre de documentation

Alibaba Cloud Model Studio:Référence de l'API HappyOyster-Directing-Query Travel List

Dernière mise à jour :Oct 11, 2026

Paginer à travers les Voyages Directing sous le compte principal actuel, avec un filtrage optionnel par statut ou par Monde associé.

Scope

Paginer les voyages de mise en scène sous le compte principal actuel, avec un filtrage optionnel par statut ou par monde associé. Avant d'effectuer l'appel, confirmer les points suivants :

  • Authentification : Seule la clé API principale est prise en charge ; les clés API temporaires ne peuvent pas être utilisées (code d'erreur 403003).

  • Appelant : Appelé par votre serveur.

Requête HTTP

Singapore

GET https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v2/apps/happyoyster-1.0-directing/openapi/v1/travels

Remplacez {WorkspaceId} par votre véritable ID d'espace de travail.

États-Unis (Virginie)

GET https://{WorkspaceId}.us-east-1.maas.aliyuncs.com/api/v2/apps/happyoyster-1.0-directing/openapi/v1/travels

Remplacez {WorkspaceId} par votre véritable ID d'espace de travail.

Paramètres de la requête

Interroger la liste des Travels

curl --location 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v2/apps/happyoyster-1.0-directing/openapi/v1/travels?page=1&pageSize=20&status=completed&encryptedWorldId={encryptedWorldId}' \
    -H "Authorization: Bearer $DASHSCOPE_API_KEY"

Authorization string (Requis)

Authentification par clé API. Seule la clé API principale est prise en charge ; elle commence par sk-, par ex. sk-xxx. Elle est généralement configurée comme variable d'environnement $DASHSCOPE_API_KEY. Une clé API temporaire (commençant par st-) renvoie 403003.

Paramètres de requête

page integer (Facultatif)

Numéro de page, par défaut 1. Lorsque page <= 0, il est traité comme 1.

pageSize integer (Facultatif)

Éléments par page, par défaut 20. Lorsque pageSize <= 0, il est traité comme 20 ; lorsqu'il est supérieur à 100, il est plafonné à 100.

status string (Facultatif)

Filtrer par statut de Travel. Les valeurs inconnues ne sont pas appliquées comme filtre. Valeurs autorisées :

  • init : initialisation des ressources de session
  • pending : en file d'attente ou en attente de ressources de service
  • running : en cours d'exécution
  • failed : le Travel a échoué
  • completed : le Travel est terminé ; les artefacts peuvent être interrogés

encryptedWorldId string (Facultatif)

Un ID de Monde chiffré Directing sous le compte principal actuel. Lorsqu'il est fourni, seuls les Voyages de ce Monde sont retournés. Ce point de terminaison limite automatiquement les résultats au modèle Directing et ne prend pas en charge le paramètre de requête mode.

Paramètres de réponse

{
    "code": 0,
    "message": null,
    "data": {
        "items": [
            {
                "encryptedTravelId": "trvl_a1b2****",
                "status": "completed",
                "mode": 2,
                "encryptedWorldId": "enc_a1b2****",
                "durationSec": 180,
                "createdAt": "2026-06-03T10:00:00Z",
                "endedAt": "2026-06-03T10:03:00Z"
            },
            {
                "encryptedTravelId": "trvl_g7h8****",
                "status": "completed",
                "mode": 2,
                "encryptedWorldId": "enc_a1b2****",
                "durationSec": null,
                "createdAt": "2026-06-03T11:00:00Z",
                "endedAt": "2026-06-03T11:03:00Z"
            }
        ],
        "pagination": {
            "page": 1,
            "pageSize": 20,
            "total": 2,
            "hasMore": false
        }
    }
}

code integer

Code de retour. 0 indique un succès ; une valeur non nulle correspond à un code d'erreur.

message string

Message d'erreur. null en cas de succès.

data object

Données de réponse. null en cas d'échec.

Propriétés

items array

Les Voyages sur la page actuelle ; un tableau vide lorsqu'il n'y a aucun résultat. Chaque élément contient encryptedTravelId, status, mode (toujours 2), encryptedWorldId, durationSec (null lorsque l'exécution est en cours ou que le montage final n'est pas encore prêt), createdAt et endedAt (null lorsque l'exécution est en cours).

pagination object

Informations de pagination. Contient page, pageSize, total et hasMore.

États préalables et notes d'appel

  • Le filtre de modèle s'applique automatiquement, et items[].mode est toujours 2.
  • Lors du filtrage avec encryptedWorldId, ce monde doit appartenir au compte principal actuel et au modèle de mise en scène ; un ID de monde provenant d'un autre modèle retourne 403001.
  • Pour un voyage en cours, durationSec et endedAt peuvent être null.
  • Un status inconnu ne déclenche pas d'erreur ; il est traité comme une absence de filtre de statut. Pour un statut de pause côté serveur, interroger un voyage unique via Interroger le statut du voyage.

Codes d'erreur

Si l'appel du modèle échoue et renvoie une erreur, consultez Codes d'erreur HappyOyster pour la résoudre.

Étapes suivantes