Saltar para o conteúdo
Referência da API
/
Telefones na Nuvem
/
/Apps

Instale o aplicativo no celular na nuvem.

Request

Instala um app da biblioteca da equipe em um Cloud Phone.

  • Pré-requisitos: o telefone precisa estar ligado e não pode estar reservado por outro membro da equipe. O app já precisa existir na biblioteca da equipe ou no catálogo público; identifique-o por appVersionId ou por packageName mais versionCode. Ele também precisa ter sido enviado ao serviço que atende este telefone, caso contrário a instalação falha.
  • Limite de taxa: no máximo uma instalação por telefone por segundo; uma segunda chamada mais rápida é rejeitada.
  • Conclusão: aceito, não concluído. A resposta apenas confirma que a solicitação entrou na fila. Consulte /cloudphone/app/installedList para verificar se o app chegou.
  • Nova tentativa: é seguro repetir depois de verificar a lista de instalados, respeitando o limite de um por segundo.

Erros de negócio documentados: 33005, 33014, 33714. Consulte Error Codes para o significado de cada código. Qualquer operação também pode retornar os códigos comuns.

Bodyapplication/json
appVersionIdstring

ID da versão do aplicativo

idstringrequired

ID do telefone na nuvem

packageNamestring

Nome do pacote — obrigatório apenas se appVersionId não for fornecido.

versionCodeinteger

Código da versão — necessário apenas se o appVersionId não for fornecido.

curl -i -X POST \
  http://127.0.0.1:40000/api/cloudphone/app/install \
  -H 'Content-Type: application/json' \
  -d '{
    "appVersionId": "1672940217990530",
    "id": "1673823102599682"
  }'

Responses

Sucesso. data é um único valor booleano.

Headers
any
Bodyapplication/json
codeinteger
msgstring or null
databoolean
requestIdstring
Response
{
  "code": 0,
  "msg": null,
  "data": true,
  "requestId": "0d8b6f1c-9f4e-4d02-9d1a-7c3f5a1b2c3d"
}