Skip to main content

Référence de l'API HappyOyster-Directing-Rewind Travel

Rembobiner un Voyage à un horodatage vidéo spécifié et reprendre l'exécution depuis le point d'atterrissage réel. Le Voyage doit d'abord entrer dans l'état paused.

Scope

Rembobiner un Voyage à un horodatage vidéo spécifié et reprendre l'exécution depuis le point d'atterrissage réel. Avant d'appeler, confirmez les points suivants :
  • Authentification : La clé API principale n'est pas requise ; la clé principale ou une clé API temporaire peut l'appeler. Pour savoir comment les obtenir, voir Obtenir les identifiants d'authentification.
  • Prérequis : Le Voyage doit d'abord entrer dans l'état paused ; il ne peut pas être rembobiné directement pendant running. Confirm via Interroger le statut du voyage.
  • Appelant : Votre serveur ou votre client peut l'appeler.

Requête HTTP

  • Singapore
  • États-Unis (Virginie)
POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v2/apps/happyoyster-1.0-directing/openapi/v1/travels/rewindRemplacez {WorkspaceId} par votre véritable ID d'espace de travail.

Paramètres de la requête

  • Rembobiner le voyage
curl --location 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v2/apps/happyoyster-1.0-directing/openapi/v1/travels/rewind' \
    -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
    -H 'Content-Type: application/json' \
    -d '{
    "encryptedTravelId": "{encryptedTravelId}",
    "rewindToSec": 84.0,
    "userAgent": "your-client/1.2.0"
}'
Content-Typestring(Requis)Type de contenu de la requête. Ce paramètre doit être défini sur application/json.
Authorization string (Requis)Authentification par clé API. La clé API principale n'est pas requise ; la clé principale ou une clé API temporaire peut l'appeler.
  • Clé API principale : commence par sk-, par ex. sk-xxx.
  • Clé API temporaire : commence par st-, par exemple st-xxx.
Corps de la requête
encryptedTravelId string (Obligatoire)L'ID de Voyage chiffré Directing à rembobiner. Retourné par Entrer dans le voyage.
rewindToSec number (Obligatoire)Le temps vidéo cible, en secondes. Supérieur ou égal à 0 ; un multiple de 4 est recommandé (tel que 4, 8, 12). Le serveur l'arrondit à la limite de 4 secondes la plus proche en utilisant Math.round(rewindToSec / 4) × 4. Le point d'atterrissage réel est déterminé par resumedAtSec / actualRewindToSec dans la réponse.userAgent string (Facultatif)Identifiant de version du SDK ou du client. Une chaîne non vide ; prévaut sur le User-Agent HTTP.

Paramètres de réponse

  • Rembobinage réussi
{
    "code": 0,
    "message": null,
    "data": {
        "encryptedTravelId": "trvl_a1b2****",
        "status": "running",
        "resumedAtSec": 84.0,
        "actualRewindToSec": 84.0
    }
}
code integerCode de retour. 0 indique un succès ; une valeur non nulle correspond à un code d'erreur.
message stringMessage d'erreur. null en cas de succès.
data objectDonnées de réponse. null en cas d'échec.

Propriétés

encryptedTravelId stringL'identifiant de voyage chiffré.status stringLe statut après la fin du rembobinage ; retourne running.resumedAtSec numberLe nombre réel de secondes auquel la lecture reprend ; il peut s'écarter légèrement de la valeur demandée.actualRewindToSec numberLe point d'atterrissage réel du rembobinage ; identique à resumedAtSec.

États préalables et notes d'appel

  • Le Voyage doit d'abord entrer en paused ; il ne peut pas être rembobiné directement pendant running.
  • Mettre le voyage en pause a une barrière de confirmation asynchrone d'environ 3 secondes. Après avoir reçu la réponse de pause, vous devez continuer à poller Interroger le statut du voyage et confirmer que le statut visible extérieurement est déjà paused avant d'appeler ce point de terminaison.
  • Le script est organisé en Blocs de 4 secondes ; un multiple de 4 tel que 4, 8 ou 12 est recommandé pour rewindToSec (par exemple, 6 → 8).
  • Le point d'atterrissage réel est déterminé par resumedAtSec / actualRewindToSec.

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

Après le rembobinage, le Voyage revient à running :