Skip to main content

Referencia de la API HappyOyster-Adventure-End Travel

Finalice activamente un Adventure Travel. Después de una finalización normal entra en completed; en una finalización por tiempo de espera sin flujo entra en failed y no se generan artefactos de repetición. El servidor también lo finaliza automáticamente cuando se alcanza maxExperienceTimeSec.

Ámbito

Finalice activamente un Adventure Travel. Después de una finalización normal, el Travel entra en completed; en una finalización por tiempo de espera sin flujo, entra en failed. Antes de realizar la llamada, confirme lo siguiente:
  • Autenticación: La clave de API principal no es obligatoria; pueden invocarla tanto la clave principal como una temporal. Para saber cómo obtenerlas, consulte Obtener credenciales de autenticación.
  • Requisitos previos: El viaje no debe haber entrado todavía en un estado terminal y debe estar en un estado que el servidor pueda finalizar. Confírmelo mediante Consultar estado del viaje.
  • Solicitante: Puede invocarla su servidor o su cliente.

Solicitud HTTP

  • Singapore
  • China (Beijing)
  • EE. UU. (Virginia)
POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v2/apps/happyoyster-1.0-adventure/openapi/v1/travels/endReemplace {WorkspaceId} con su ID de espacio de trabajo real.

Parámetros de solicitud

  • Finalización normal
  • Finalización por tiempo de espera sin flujo
curl --location 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v2/apps/happyoyster-1.0-adventure/openapi/v1/travels/end' \
    -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
    -H 'Content-Type: application/json' \
    -d '{
    "encryptedTravelId": "{encryptedTravelId}",
    "userAgent": "HappyOyster-Web/0.1.0"
}'
Content-Typestring(Requerido)Tipo de contenido de la solicitud. Este parámetro debe establecerse en application/json.
Authorization string (Requerido)Autenticación mediante clave de API. No se requiere la clave de API principal; pueden invocarla tanto la clave principal como una temporal.
  • Clave de API principal: comienza con sk-, por ejemplo, sk-xxx.
  • Clave de API temporal: comienza con st-, por ejemplo, st-xxx.
Cuerpo de la solicitud
encryptedTravelId string (Obligatorio)El ID de Travel cifrado de Adventure que se va a finalizar. Devuelto por Entrar al Travel.
failCode string (Opcional)El motivo de finalización por fallo para un tiempo de espera sin flujo. Cuando se omite, se trata como una finalización normal. Actualmente solo se admite:
  • TRAVEL_NO_STREAM_AUTO_END: para el escenario en el que no se recibe ningún flujo después de entrar en la sala durante más de noStreamAutoEndTimeoutSec; este tipo de finalización no genera artefactos de reproducción
Pasar un valor no compatible devuelve 400000.
userAgent string (Opcional)Identificador de versión del SDK o del cliente. Una cadena no vacía; tiene prioridad sobre el User-Agent HTTP.

Parámetros de respuesta

  • Finalización normal
  • Finalización por tiempo de espera sin flujo
{
    "code": 0,
    "message": null,
    "data": {
        "encryptedTravelId": "trvl_a1b2****",
        "status": "completed",
        "errorCode": null,
        "errorMessage": null,
        "endedAt": "2026-06-04T00:03:00Z",
        "durationSec": 90
    }
}
code integerCódigo de retorno. 0 indica éxito; un valor distinto de cero es un código de error.
message stringMensaje de error. null en caso de éxito.
data objectDatos de respuesta. null en caso de fallo.

Propiedades

encryptedTravelId stringEl ID de viaje cifrado que se finalizó.status stringEstado de finalización:
  • completed: finalización normal
  • failed: finalización por fallo cuando se proporciona un failCode compatible
errorCode stringCódigo de motivo de fallo; null en una finalización normal.errorMessage stringDescripción del fallo; null en una finalización normal.endedAt stringHora de finalización, en formato ISO 8601.durationSec integerDuración efectiva del video en segundos; null en una finalización por fallo sin flujo o cuando la duración aún no se puede analizar.

Estados previos y notas de llamada

  • El encryptedTravelId debe pertenecer a la cuenta principal actual y al modelo Adventure.
  • Cuando se omite failCode, se trata como una finalización normal; pasar un valor no compatible devuelve 400000.
  • El servidor finaliza automáticamente el Travel una vez que se alcanza maxExperienceTimeSec; el cliente debe converger su estado local a partir de las devoluciones de llamada de estado o los resultados de la consulta de estado.
  • En una finalización normal, durationSec utiliza preferentemente la duración real del video finalizado disponible; puede ser null cuando la duración del video finalizado aún no se puede analizar.
  • Después de que una finalización normal alcance completed, los artefactos compuestos pueden seguir procesándose; consúltelos y sondee según Consultar artefactos del viaje.

Códigos de error

Si la llamada al modelo falla y devuelve un error, consulte Códigos de error de HappyOyster para resolverlo.

Siguientes pasos

Después de que el viaje entre en completed: