Skip to main content

Referência da API HappyOyster-Directing-Rewind Travel

Retroceder uma Viagem para um carimbo de data/hora de vídeo especificado e retomar a execução a partir do ponto real de aterrissagem. A Viagem deve primeiro entrar no estado pausado.

Escopo

Retroceder uma Viagem para um carimbo de data/hora de vídeo especificado e retomar a execução a partir do ponto real de aterrissagem. Antes de chamar, confirme o seguinte:
  • Autenticação: A Chave de API primária não é obrigatória; tanto a chave primária quanto uma temporária podem chamá-la. Para saber como obtê-las, veja Obter credenciais de autenticação.
  • Pré-requisitos: A Viagem deve primeiro entrar no estado paused; ela não pode ser retrocedida diretamente enquanto estiver running. Confirm via Consultar Status da Viagem.
  • Chamador: Tanto seu servidor quanto seu cliente podem fazer a chamada.

Solicitação HTTP

  • Singapore
  • EUA (Virgínia)
POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v2/apps/happyoyster-1.0-directing/openapi/v1/travels/rewindSubstitua {WorkspaceId} pelo seu ID do Workspace real.

Parâmetros da solicitação

  • Retroceder Viagem
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(Obrigatório)Tipo de conteúdo da solicitação. Este parâmetro deve ser definido como application/json.
Authorization string (Obrigatório)Autenticação por Chave de API. A Chave de API primária não é obrigatória; tanto a chave primária quanto uma temporária podem chamá-lo.
  • API Key Primária: começa com sk-, ex. sk-xxx.
  • Chave de API Temporária: começa com st-, por exemplo, st-xxx.
Corpo da solicitação
encryptedTravelId string (Obrigatório)O ID de Viagem criptografado do Directing a ser retrocedido. Retornado por Entrar na Viagem.
rewindToSec number (Obrigatório)O tempo alvo do vídeo, em segundos. Maior ou igual a 0; um múltiplo de 4 é recomendado (como 4, 8, 12). O servidor o arredonda para o limite de 4 segundos mais próximo usando Math.round(rewindToSec / 4) × 4. O ponto real de aterrissagem é determinado por resumedAtSec / actualRewindToSec na resposta.userAgent string (Opcional)Identificador de versão do SDK ou cliente. Uma string não vazia; tem precedência sobre o User-Agent HTTP.

Parâmetros de resposta

  • Retrocesso bem-sucedido
{
    "code": 0,
    "message": null,
    "data": {
        "encryptedTravelId": "trvl_a1b2****",
        "status": "running",
        "resumedAtSec": 84.0,
        "actualRewindToSec": 84.0
    }
}
code integerCódigo de retorno. 0 indica sucesso; diferente de zero é um código de erro.
message stringMensagem de erro. null em caso de sucesso.
data objectDados da resposta. null em caso de falha.

Propriedades

encryptedTravelId stringO Travel ID criptografado.status stringO status após a conclusão do retrocesso; retorna running.resumedAtSec numberO número real de segundos em que a reprodução é retomada; pode desviar ligeiramente do valor solicitado.actualRewindToSec numberO ponto real de aterrissagem do retrocesso; idêntico a resumedAtSec.

Estados pré-requisitos e notas de chamada

  • A Viagem deve primeiro entrar em paused; ela não pode ser retrocedida diretamente enquanto estiver running.
  • Pausar Viagem tem uma barreira de confirmação assíncrona de cerca de 3 segundos. Após receber a resposta de pausa, você ainda deve fazer polling em Consultar Status da Viagem e confirmar se o status visível externamente já é paused antes de chamar este endpoint.
  • O script é organizado em Blocos de 4 segundos; um múltiplo de 4, como 4, 8 ou 12, é recomendado para rewindToSec (por exemplo, 6 → 8).
  • O ponto real de aterrissagem é determinado por resumedAtSec / actualRewindToSec.

Códigos de erro

Se a chamada do modelo falhar e retornar um erro, consulte Códigos de Erro do HappyOyster para resolvê-lo.

Próximos passos

Após o retrocesso, a Viagem retorna a running: