Envie o conjunto completo de 45 turnos em uma Travel no modo script para substituir totalmente os atos da Travel atual. Apenas creationModel=scriptlist é suportado.
Escopo
Envie o conjunto completo de 45 turnos em uma Travel no modo script (creationModel=scriptlist) para substituir totalmente os acts da Travel atual. 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: O
creationModelda Travel deve serscriptlist, e seu status deve serrunningoupending. Confirme via Consultar Status da Travel. - 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/update-scriptSubstitua {WorkspaceId} pelo seu ID do Workspace real.Parâmetros da solicitação |
O exemplo mostra apenas os atos 1 e 2 para ilustrar a estrutura e não deve ser enviado como está. Uma solicitação real deve conter todas as 45 entradas, do turno 1 ao 45, contíguas e sem duplicatas. |
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.
| |
Corpo da solicitação | |
encryptedTravelId string (Obrigatório)O ID criptografado da Travel de Direção a ser atualizado; seu creationModel deve ser scriptlist. Retornado por Entrar na Travel. | |
scriptList object (Obrigatório)Contêiner completo do script. Apenas acts tem efeito; mesmo que inclua subjects, synopsis, scene, style, speed, language, setting, soundtrack, prologue ou videoTags, esses campos são ignorados e a plataforma continua usando os valores salvos na criação do Mundo.scriptList.acts array (Obrigatório)Lista completa de atos. Restrições:
| |
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 |
|
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.accepted booleanSe o script completo foi aceito e entrou no fluxo de processamento.turnCount integerO número de turnos nesta atualização completa, fixado em 45. |
Estados pré-requisitos e notas de chamada
- Apenas
creationModel=scriptlistsuporta este endpoint; uma Viagem em modo padrão que o chamar por engano retornará409000. - O status da Viagem deve ser
runningoupending. actsdeve ter exatamente 45 entradas; turn deve ser 1–45, contíguo e não duplicado, caso contrário400000é retornado.- Conteúdo de script que falha na política de segurança de conteúdo retorna
403004; uma rejeição de conformidade de direitos autorais ou PI retorna403005.
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 a atualização:
- Consultar Status da Viagem: visualizar informações do capítulo.
- Pausar Viagem / Retroceder Viagem.
- End Travel: encerrar a sessão e processar artefatos.