Consultar o progresso de construção de um Mundo Adventure. A API retorna o ID criptografado do Mundo, o status de construção e a URL do primeiro quadro; o cliente sonda até que o Mundo entre em ready.
Escopo
Consultar o progresso de construção de um Mundo Adventure. Antes de chamar, confirme o seguinte:
- Autenticação: A chave de API primária não é necessária; tanto a chave primária quanto uma temporária podem chamar este endpoint. Para saber como obtê-las, veja Obter credenciais de autenticação.
- Pré-requisitos: Consulte com o
encryptedWorldIdretornado por Criar Mundo. Você pode começar a consultar a partir do estadogenerating. - Chamador: Tanto seu servidor quanto seu cliente podem fazer a chamada.
Solicitação HTTP
- Singapore
- China (Pequim)
- EUA (Virgínia)
GET https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v2/apps/happyoyster-1.0-adventure/openapi/v1/worlds/build-statusSubstitua {WorkspaceId} pelo seu ID do Workspace real.Parâmetros da solicitação |
|
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.
| |
Parâmetros de consulta | |
encryptedWorldId string (Obrigatório)O ID criptografado do Mundo retornado por Criar Mundo. Ele é criptografado pelo servidor; você não precisa descriptografá-lo. |
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 encryptedWorldId stringID do Mundo criptografado.status stringStatus da construção:
stringURL do primeiro quadro do Mundo; null quando ainda não gerado ou quando a construção falhou.name stringNome do Mundo. Retornado apenas quando status=ready.mode integerSempre 1 para Adventure. Retornado apenas quando status=ready. |
Estados pré-requisitos e notas de chamada
- Sonde a cada 3–5 segundos até que
statussejareadyoufailed. - Apenas um Mundo
readypode trocar por uma credencial de viagem e entrar na sala. - Quando uma imagem de URL falha na validação após o armazenamento assíncrono, o Mundo pode passar de
generatingparafailed. - Este endpoint não retorna
aspectRatio; quando você precisar de metadados de criação comoperspectiveouuploadMode, chame Consultar Detalhes do Mundo.
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
Depois que o Mundo entra em ready:
- Obter Credencial de Viagem: trocar por um
ticketde uso único. - Consultar Detalhes do Mundo: consulte os metadados completos da criação.