Skip to main content

Referencia de la API HappyOyster-Acting-Resume Travel

Reanude un Acting Travel en pausa para que vuelva al estado de ejecución.

Ámbito

Reanude un Acting Travel en pausa para que vuelva al estado de ejecución. 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 Travel debe confirmarse como paused mediante Consultar estado del Travel.
  • Solicitante: Puede invocarla su servidor o su cliente.

Solicitud HTTP

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

Parámetros de solicitud

  • Reanudar Travel
curl --location 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v2/apps/happyoyster-1.0-acting/openapi/v1/travels/resume' \
    -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
    -H 'Content-Type: application/json' \
    -d '{
    "encryptedTravelId": "{encryptedTravelId}",
    "userAgent": "HappyOyster-Web/1.2.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 Acting que se va a reanudar. Devuelto por Entrar al Travel.
userAgent string (Opcional)Identificador de versión del SDK o cliente. Una cadena no vacía; tiene prioridad sobre el User-Agent HTTP, utilizado para estadísticas de versión del SDK y plataforma.

Parámetros de respuesta

  • Reanudación exitosa
{
    "code": 0,
    "message": null,
    "data": {
        "encryptedTravelId": "trvl_a1b2****",
        "status": "running"
    }
}
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.status stringEl estado después de reanudar; devuelve running.

Estados previos y notas de llamada

  • El Travel debe confirmarse como paused mediante Consultar estado del Travel.
  • El version en la respuesta de entrada a la sala debe ser actingV2.
  • Un Travel que ya ha terminado o fallado no se puede reanudar.
  • Después de reanudar, puede continuar enviando instrucciones de proceso de texto; el cliente debe converger su estado de ejecución local basándose en el resultado de la consulta de estado.
  • Reanudar no cambia el aspectRatio devuelto al entrar en la sala.

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 reanudar, puede: