コンテンツへスキップ
API リファレンス
/
/
/
クラウドフォンにアプリをインストールする

クラウドフォンにアプリをインストールする

Request

チームのアプリライブラリからクラウドフォンへアプリをインストールします。

  • 前提条件：クラウドフォンが起動済みで、他のメンバーに占有されていないこと。アプリはチームライブラリまたは公開カタログに既に存在している必要があり、appVersionId か packageName + versionCode のいずれかで指定します。また、そのクラウドフォンを提供するデバイスサービスへアップロード済みでなければインストールは失敗します。
  • レート制限：1 台につき 1 秒あたり 1 回まで。これより早い 2 回目の呼び出しは拒否されます。
  • 完了シグナル：受理されただけで、完了ではありません。 レスポンスはリクエストがキューに入ったことのみを示します。/cloudphone/app/installedList をポーリングしてアプリが届いたか確認してください。
  • リトライ：インストール済み一覧を確認した上で、1 秒 1 回の制限を守れば安全にリトライできます。

文書化されたビジネスエラー: 33005, 33014, 33714。 各コードの意味は Error Codes を参照してください。どの操作でも共通コードが返る場合があります。

Bodyapplication/json
appVersionIdstring

アプリのバージョンID

idstringrequired

クラウド電話ID

packageNamestring

パッケージ名 — appVersionId が指定されていない場合にのみ必須

versionCodeinteger

バージョンコード — appVersionId が指定されていない場合にのみ必要です

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

成功。data は単一の boolean 値です。

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