メインコンテンツまでスキップ
API docs by Redocly

CWS APIリファレンス (1.0)

Download OpenAPI specification:Download

CWS APIのAPI外形を定義します。

非推奨機能について

CWS APIでは、機能追加・変更・改善に伴い非推奨となった機能を、原則として最低6ヶ月の移行期間を経て廃止します。

非推奨機能は、APIリファレンスにてDeprecatedと表記しています。

非推奨機能となる場合や非推奨機能の廃止は、お知らせにてご案内します。

廃止を予定している非推奨機能や、これまで廃止された機能については、廃止機能を参照してください。

エラーレスポンスについて

  • CWS API では、HTTP ステータスコードのみではエラー内容を十分に表現できない場合に、エラーレスポンスボディを返却します。
  • エラーレスポンスボディを返却する場合、messageもしくはreasonに、発生したエラーの概要を示します。
  • 発生したエラーに詳細情報がある場合は、detailsにエラー内容の詳細を示します。

利用者様THINKLETアプリからのファイルアップロードについて

THINKLETにインストールされた利用者様アプリのデータを、利用者様指定の保存先にアップロードするために、Amazon S3の署名付きURL取得URL、及びイベント通知先URLを利用者様でご用意ください。

利用者様で用意いただいた各URLを利用して、CWS APIでは次の処理を行います。

データをアップロードするため、下記で設定されたURLに対して署名付きURL発行を依頼します

  • fileUploadGetUrl（ファイルアップロード用署名付きURL取得URL)

アップロードの成功/失敗は、下記で設定されたURLに対して通知します

  • fileUploadEvent (ファイルアップロード用イベント通知先URL)

ファイルアップロード利用の詳細に関しては、ファイルアップロード用署名付きURL取得を参照ください。

通知・アクセス設定、authenticationKeyを発行する で登録・更新できる設定値について

通知・アクセス設定、authenticationKeyを発行するで必要な設定が行われていない場合、一部機能が利用できなくなります。
それぞれの設定値と制限がかかる機能は以下となります。

  • authenticationKey
    • この設定は、多くの機能で使用しています。
      未設定の場合、殆どの機能が利用できないため、必ずauthenticationKeyを発行するを行ってください。
      この設定は、CWS APIを安全にご利用いただくために、Webhookによる通知の検証に使用します。詳しくはauthenticationKeyの利用方法を参照してください。
  • deviceEvent
    • この設定は、端末で発生したイベントを送信、トランザクションの端末側実行結果の通知に使用しています。
      未設定の場合、トランザクションを発行するAPIと端末で発生したイベントの通知は利用できません。
  • soraEvent
    • この設定は、通話で発生したイベントの送信に使用しています。
      未設定の場合、通話は行うことができますが、通話で発生したイベントが通知されません。
  • soraFileSendEvent
    • この設定は、録画データ保存結果の通知に使用しています。
      未設定の場合、録画データがアップロードされません。
  • soraRecGetMultiPresignedUrl
    • この設定は、録画データ保存時の署名付きURL取得に使用しています。
      未設定の場合、録画データがアップロードされません。
  • fileUploadEvent
    • この設定は、ファイルアップロードイベントの通知に使用しています。
      未設定の場合、ファイルアップロード機能は利用できません。
  • fileUploadGetUrl
    • この設定は、ファイルアップロード機能の署名付きURL取得に使用しています。
      未設定の場合、ファイルアップロード機能は利用できません。

Connectivityの各APIの利用について

Connectivity の各APIは、下記バージョン以降のFwに対応しています。

  • Fw 9.001.0以上（mdmclient 2.3.1以上）

THINKLETのFwが上記のバージョン未満の場合、正常に動作しません。 上記バージョン未満のFwがインストールされているTHINKLETに対して、Connectivityの各APIを実行した場合は、トランザクションが未処理のままとなってしまうため、トランザクションをキャンセルするを実行して、トランザクションをキャンセルしてください。

THINKLETとBluetoothデバイスとのペアリング方法

Bluetooth/ネットワークの種別(type)を指定する各API について

  • 現在は Bluetooth のみ対応しています。
  • 当面は Bluetooth/ネットワークの種別 に wifi, mobile が指定された場合、400エラーを返却します。

Authenticate

Authenticate Apis

アクセストークンを発行する

アプリケーションID・アプリケーションシークレットを用いて（grant_type=client_credentials で）アクセストークンを発行します。

アクセストークンの発行方法・利用方法の詳細はAPI認証設定を参照ください。

Authorizations:
basicAuth
Request Body schema: application/x-www-form-urlencoded
required
grant_type
required
string
Value: "client_credentials"

認可グラントタイプ。クライアント認証情報を用いたアクセストークン発行のみ対応します。

scope
string

発行するアクセストークンに付与するスコープ。スペース区切りで複数指定できます。 利用可能なスコープの一覧はCWS認証のスコープを参照ください。

Responses

Response samples

Content type
application/json

アクセストークン発行成功時のレスポンスの例です。 access_token は例示用のダミー値であり、デコードしても意味のある内容は含まれません。

{
  • "access_token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJFZERTQSJ9.eyJzdWIiOiJ0ZXN0IiwiZXhwIjoxNzU0NTMwNTQ5fQ.oGFZWyAhCLswTJYzBAOL8XEBAhtIotdDa4fEMghrwjAap12PGmdxAiMZAXSE7suymVURe435wqJAp2goDEPHAA",
  • "token_type": "bearer"
}

Config

Config Apis

通知・アクセス設定内容取得

自身のアプリケーションIDに紐づくシステム連携設定を取得します。

特記事項

Authorizations:
cwsAuthmimiAuth
path Parameters
applicationId
required
string

アプリケーションID

header Parameters
Authorization
string

Responses

Response samples

Content type
application/json
{}

通知・アクセス設定

自身のアプリケーションに対するシステム連携情報を登録・更新します。

特記事項

Authorizations:
cwsAuthmimiAuth
path Parameters
applicationId
required
string

アプリケーションID

header Parameters
Authorization
string
Request Body schema: application/json
deviceEvent
string <= 255 characters https?://.*

デバイスイベント通知先URL

soraEvent
string <= 255 characters https?://.*

Soraイベント通知先URL

soraFileSendEvent
string <= 255 characters https?://.*

Sora録画データ通知先URL

soraRecGetMultiPresignedUrl
string <= 255 characters https?://.*

録画データ（Sora）用署名付きURL取得URL（マルチパート対応）

fileUploadEvent
string <= 255 characters https?://.*

ファイルアップロードイベント通知先URL

fileUploadGetUrl
string <= 255 characters https?://.*

ファイルアップロード先URL取得URL

Responses

Request samples

Content type
application/json
{}

authenticationKeyを発行する

自身のアプリケーションIDに紐づくauthenticationKeyを発行する

特記事項

  • 本APIを実行することで、authenticationKey が発行されます。
    • authenticationKeyを未発行である場合、新規発行されます。
    • authenticationKeyを発行済である場合、既存Keyは無効となり、新規発行Keyが有効となります。
  • 発行済みのauthenticationKeyを取得する場合は、通知・アクセス設定内容取得を利用してください
Authorizations:
cwsAuthmimiAuth
path Parameters
applicationId
required
string

アプリケーションID

header Parameters
Authorization
string

Responses

Response samples

Content type
application/json
{
  • "authenticationKey": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
}

Device

Device(& Hardware Properties) Apis

デバイスのアクティベート状態を取得する

概要

本APIはデバイスのアクティベート・ディアクティベート状態を取得するAPIです。Path Parameters で指定されたアプリケーションに対し、デバイスがアクティベートされていた場合 status はactivated 、clientIdはmimiのクライアントIDとなります。デバイスがデベロッパーに紐づいているかつ、デベロッパー内のどのアプリケーションにも紐づいていない場合、deactivated となります。他のapplicationでactivateされている場合はHTTP 403を返却します。

Authorizations:
cwsAuthmimiAuth
path Parameters
deviceId
required
string

THINKLETのIMEI番号

applicationId
required
string

アプリケーションID

header Parameters
Authorization
string

Responses

Response samples

Content type
application/json
Example
{
  • "status": "activated",
  • "clientId": "123e8f0fd2c044ef9074ef0b84d1cf88"
}

デバイスをアクティベートする

デバイスをアクティベートします。

CWS APIの利用申込みを実施していない場合や、本API実行時のアクティベート数が、申込みしたTHINKLETの台数に達していた場合、本APIでエラーを返却します。

Authorizations:
cwsAuthmimiAuth
path Parameters
deviceId
required
string

THINKLETのIMEI番号

applicationId
required
string

アプリケーションID

header Parameters
Authorization
string
Request Body schema: application/json
mimiClientId
string
mimiClientSecret
string

Responses

Request samples

Content type
application/json
{
  • "mimiClientId": "string",
  • "mimiClientSecret": "string"
}

Response samples

Content type
application/json
{
  • "transactionId": 1
}

デバイスをディアクティベートする

デバイスをディアクティベートします。

Authorizations:
cwsAuthmimiAuth
path Parameters
deviceId
required
string

THINKLETのIMEI番号

applicationId
required
string

アプリケーションID

header Parameters
Authorization
string

Responses

Response samples

Content type
application/json
{
  • "transactionId": 1
}

デバイス状態取得

デバイスの状態を取得します。

補足

  • lang
    • 端末に設定されている言語設定を返却します。形式の詳細は言語設定をするを参照してください。
Authorizations:
cwsAuthmimiAuth
path Parameters
deviceId
required
string

THINKLETのIMEI

applicationId
required
string

アプリケーションID

header Parameters
Authorization
string

Responses

Response samples

Content type
application/json
{
  • "power": "started",
  • "powerUpdateDate": "2024-10-24T14:15:22.123456",
  • "wearing": "device_wear",
  • "wearingUpdateDate": "2024-10-24T14:15:22.123456",
  • "network": "connectivity_online",
  • "networkUpdateDate": "2024-10-24T14:15:22.123456",
  • "charging": "stop_charging",
  • "chargingUpdateDate": "2024-10-24T14:15:22.123456",
  • "batteryPercentage": 89,
  • "batteryUpdateDate": "2024-10-24T14:15:22.123456",
  • "latitude": 35.6809591,
  • "longitude": 139.7673068,
  • "locationUpdateDate": "2024-10-24T14:15:22.123456",
  • "firmware": {
    },
  • "app": [
    ],
  • "lang": [
    ]
}

デバイス状態の一覧を取得

指定したアプリケーションIDに属するデバイスの状態の一覧を取得します。

補足

  • lang
    • 端末に設定されている言語設定を返却します。形式の詳細は言語設定をするを参照してください。
Authorizations:
cwsAuthmimiAuth
path Parameters
applicationId
required
string

アプリケーションID

header Parameters
Authorization
string

Responses

Response samples

Content type
application/json
[
  • {
    }
]

デバイスのハードウェアプロパティを取得する

概要

本APIは、指定したdeviceIdのハードウェアプロパティを取得するAPIです。

Authorizations:
cwsAuthmimiAuth
path Parameters
deviceId
required
string

THINKLETのIMEI

header Parameters
Authorization
string

Responses

Response samples

Content type
application/json
Example
{
  • "deviceId": "123456789012345",
  • "model": {
    },
  • "camera": [
    ],
  • "macAddressWifi": "0a:1b:2c:3d:4e:5f",
  • "macAddressBluetooth": "9a:8b:7c:6d:5e:4f"
}

Network

Network Apis

APNの設定をする

指定したデバイスのAPN設定情報を更新します。

Authorizations:
cwsAuthmimiAuth
path Parameters
deviceId
required
string

THINKLETのIMEI

applicationId
required
string

アプリケーションID

header Parameters
Authorization
string
Request Body schema: application/json
Array
name
required
string [ 1 .. 100 ] characters
apn
required
string [ 1 .. 100 ] characters
proxy
string <= 100 characters
port
string <= 100 characters
user
string <= 100 characters
server
string <= 100 characters
password
string
mmsc
string <= 100 characters
mcc
required
string [ 1 .. 100 ] characters
mnc
required
string [ 1 .. 100 ] characters
mmsproxy
string <= 100 characters
mmsport
string <= 100 characters
authType
integer
type
string <= 100 characters
protocol
string <= 100 characters
carrierEnabled
string <= 100 characters
bearer
integer
bearerBitmask
integer
roamingProtocol
string <= 100 characters
mvnoType
string <= 100 characters
mvnoMatchData
string <= 100 characters

Responses

Request samples

Content type
application/json
[
  • {
    }
]

Response samples

Content type
application/json
{
  • "transactionId": 1
}

Wi-Fiを設定する

指定したデバイスのWi-Fi情報を更新します。

Authorizations:
cwsAuthmimiAuth
path Parameters
applicationId
required
string

アプリケーションID

deviceId
required
string

THINKLETのIMEI

header Parameters
Authorization
string
Request Body schema: application/json
Array
ssid
required
string <= 32 characters ^[a-zA-Z0-9!-/:-@\[-`{-~]+
password
string
security
string <= 100 characters ^[a-zA-Z0-9!-/:-@¥[-`{-~]*$

暗号化方式

Responses

Request samples

Content type
application/json
[
  • {
    }
]

Response samples

Content type
application/json
{
  • "transactionId": 1
}

Connectivity

Connectivity Apis

Bluetoothデバイス/ネットワークの一覧を取得する

概要

Bluetoothデバイス/ネットワーク一覧を取得します。

  • 当面は Bluetooth のみの対応となるため type に wifi, mobile が指定された場合、400エラーを返却します。
  • 当APIの利用にあたっての留意事項は、Connectivityの各APIの利用についてを参照してください。

取得結果について

本APIの取得結果は、トランザクション結果通知(Bluetoothデバイス/ネットワークの一覧を取得) で通知します。

本APIで取得できる一覧は以下で、target によって取得対象を指定します。 target の指定がない場合、取得対象は available になります。

  • all: 本APIの要求を受け付けた時点で、THINKLETに登録済み(接続中含む) および 検出可能なBluetoothデバイス/ネットワーク
  • connected: 本APIの要求を受け付けた時点で、THINKLETに接続中のBluetoothデバイス/ネットワーク
  • available: 本APIの要求を受け付けた時点で、THINKLETに登録済み(接続中含む)のBluetoothデバイス/ネットワーク
Authorizations:
cwsAuthmimiAuth
path Parameters
applicationId
required
string

アプリケーションID

deviceId
required
string

THINKLETのIMEI

type
required
string
Enum: "bluetooth" "wifi" "mobile"

Bluetooth/ネットワークの種別

query Parameters
target
string
Enum: "all" "connected" "available"

Bluetoothデバイス/ネットワークの取得対象

header Parameters
Authorization
string

Responses

Response samples

Content type
application/json
{
  • "transactionId": 1
}

Bluetooth/ネットワークのON/OFF状態を取得する

概要

Bluetooth/ネットワークのON/OFF状態を取得します。

  • 当面は Bluetooth のみの対応となるため type に wifi, mobile が指定された場合、400エラーを返却します。
  • 当APIの利用にあたっての留意事項は、Connectivityの各APIの利用についてを参照してください。

取得結果について

本APIの取得結果は、トランザクション結果通知(Bluetooth/ネットワークのON/OFF状態を取得、変更する) で通知します。

Authorizations:
cwsAuthmimiAuth
path Parameters
applicationId
required
string

アプリケーションID

deviceId
required
string

THINKLETのIMEI

type
required
string
Enum: "bluetooth" "wifi" "mobile"

Bluetooth/ネットワークの種別

header Parameters
Authorization
string

Responses

Response samples

Content type
application/json
{
  • "transactionId": 1
}

Bluetooth/ネットワークのON/OFF状態を変更する

概要

Bluetooth/ネットワークのON/OFF状態を変更します。

  • 当面は Bluetooth のみの対応となるため type に wifi, mobile が指定された場合、400エラーを返却します。
  • 当APIの利用にあたっての留意事項は、Connectivityの各APIの利用についてを参照してください。
Authorizations:
cwsAuthmimiAuth
path Parameters
applicationId
required
string

アプリケーションID

deviceId
required
string

THINKLETのIMEI

type
required
string
Enum: "bluetooth" "wifi" "mobile"

Bluetooth/ネットワークの種別

header Parameters
Authorization
string
Request Body schema: application/json
state
required
string
Enum: "enabled" "disabled"

Responses

Request samples

Content type
application/json
{
  • "state": "enabled"
}

Response samples

Content type
application/json
{
  • "transactionId": 1
}

Bluetooth/ネットワークの設定を初期化する

概要

Bluetooth/ネットワークの設定を初期化します。

  • 当面は Bluetooth のみの対応となるため type に wifi, mobile が指定された場合、400エラーを返却します。
  • 当APIの利用にあたっての留意事項は、Connectivityの各APIの利用についてを参照してください。
Authorizations:
cwsAuthmimiAuth
path Parameters
applicationId
required
string

アプリケーションID

deviceId
required
string

THINKLETのIMEI

type
required
string
Enum: "bluetooth" "wifi" "mobile"

Bluetooth/ネットワークの種別

header Parameters
Authorization
string

Responses

Response samples

Content type
application/json
{
  • "transactionId": 1
}

Bluetoothデバイスのペアリングを行う

概要

Bluetoothデバイスをペアリングします。

Authorizations:
cwsAuthmimiAuth
path Parameters
applicationId
required
string

アプリケーションID

deviceId
required
string

THINKLETのIMEI

header Parameters
Authorization
string
Request Body schema: application/json
macAddress
required
string

Responses

Request samples

Content type
application/json
{
  • "macAddress": "00:1A:2B:3C:4D:5E"
}

Response samples

Content type
application/json
{
  • "transactionId": 1
}

ペアリング済みBluetoothデバイスを接続/切断する

概要

Bluetoothペアリング済みのデバイスを接続/切断します。

Authorizations:
cwsAuthmimiAuth
path Parameters
applicationId
required
string

アプリケーションID

deviceId
required
string

THINKLETのIMEI

header Parameters
Authorization
string
Request Body schema: application/json
macAddress
required
string
state
required
string
Enum: "connect" "disconnect"

Responses

Request samples

Content type
application/json
{
  • "macAddress": "9a:8b:7c:6d:5e:4f",
  • "state": "connect"
}

Response samples

Content type
application/json
{
  • "transactionId": 1
}

Bluetoothデバイスのペアリングを解除する

概要

Bluetoothデバイスのペアリングを解除します。

Authorizations:
cwsAuthmimiAuth
path Parameters
applicationId
required
string

アプリケーションID

deviceId
required
string

THINKLETのIMEI

header Parameters
Authorization
string
Request Body schema: application/json
macAddress
required
string

Responses

Request samples

Content type
application/json
{
  • "macAddress": "00:1A:2B:3C:4D:5E"
}

Response samples

Content type
application/json
{
  • "transactionId": 1
}

Update

FOTA & SOTA Apis

登録したソフトウェア（パッケージ）の一覧を取得する

登録したすべてのソフトウェアのpackageを一覧で取得します。

注意事項

本APIは、実行元のアプリケーションだけでなく、同一デベロッパーに属する全アプリケーションのソフトウェアのpackageを取得します。

同名のpackageを複数登録している場合、レスポンスの各アイテムに含まれるpackageIdentifierで区別してください。

Authorizations:
cwsAuthmimiAuth
path Parameters
applicationId
required
string

アプリケーションID

header Parameters
Authorization
string

Responses

Response samples

Content type
application/json
{
  • "packageList": [
    ]
}

ソフトウェア（パッケージ）を登録する

デバイスに配信するソフトウェアのpackageを登録します。

同じpackage名を持つソフトウェアを重複して登録できます。同名のpackageはpackageIdentifierで区別してください。

注意事項

  • packageIdentifierは省略可能です。省略した場合、ランダムな値（UUID等）が自動的に割り当てられます。
  • 同名のpackageの重複登録には、packageIdentifierを指定したかどうかに関わらずallowDuplicate: trueの指定が必要です。既に同名のpackageを保有している状態でallowDuplicate: trueを指定せずに登録しようとした場合、packageIdentifierを指定していても意図しない重複登録を防ぐため409エラーとなります。
  • 同一のpackage＋packageIdentifierの組み合わせは、allowDuplicateの値に関わらず重複して登録できません。
  • ai.fdで始まるpackageは使用できません。
  • 2026年9月のリリース時点で既に登録されていたパッケージについては、packageIdentifierの値はpackage名と同じ値になっています。
Authorizations:
cwsAuthmimiAuth
path Parameters
applicationId
required
string

アプリケーションID

header Parameters
Authorization
string
Request Body schema: application/json
required

登録するソフトウェアのpackage

package
required
string non-empty ^(?!ai\.fd).*$

ソフトウェアのパッケージ名。ai.fdで始まるパッケージ名は使用できません。同じpackage名を持つソフトウェアを重複して登録できます（packageIdentifierで区別）。

packageIdentifier
string [ 1 .. 255 ] characters ^[A-Za-z0-9_.-]+$

パッケージの識別子。同じpackage名を持つ既存のソフトウェアと区別するために使用する（省略可能）。省略した場合、ランダムな値（UUID等）が自動的に割り当てられる。指定したpackage＋packageIdentifierの組み合わせで既に登録がある場合はallowDuplicateの値に関わらず409エラーとなる。それ以外の場合でも、既に同名のpackageを保有している状態でallowDuplicateにtrueを指定しなければ、このpackageIdentifierが未使用の値であっても409エラーとなる（重複登録の可否はallowDuplicateでのみ判定される）。使用できる文字は半角英数字・_・-・.のみ（クエリパラメータ・パスパラメータでエンコードなしに使用できる範囲）。

allowDuplicate
boolean
Default: false

同名のpackageの重複登録を許可するかどうか（省略可能・デフォルトはfalse）。packageIdentifierの指定有無に関わらず、既に同名のpackageを保有している場合に参照される（(package, packageIdentifier)が完全一致する場合を除く。この場合は一意制約違反のためallowDuplicateの値に関わらず409エラーとなる）。trueを指定すると、既に同名のpackageを保有していても登録を許可する（packageIdentifierを省略していればランダムな値を自動的に割り当てる）。

displayName
string [ 1 .. 255 ] characters

ソフトウェアの表示名。一意識別子であるpackageとは別に、ユーザー向けの表示・管理用途で使用する名称です。

Responses

Request samples

Content type
application/json
{
  • "package": "com.example.myapp",
  • "packageIdentifier": "76bbd513-767b-4574-956d-61c117e7c948",
  • "allowDuplicate": true,
  • "displayName": "サンプルアプリケーション"
}

Response samples

Content type
application/json
{
  • "package": "string",
  • "packageIdentifier": "76bbd513-767b-4574-956d-61c117e7c948",
  • "displayName": "サンプルアプリケーション",
  • "registerDate": "2025-11-28T14:15:22.123456",
  • "updateDate": "2025-11-28T14:15:22.123456"
}

ソフトウェア（パッケージ）の表示名・識別子を更新する

登録したソフトウェアのpackageの表示名・識別子（packageIdentifier）を更新します。

同名のpackageが複数登録されている場合、currentPackageIdentifierで対象を指定してください。currentPackageIdentifierを省略した場合、対象が1件のみであればそのまま処理され、複数存在する場合は422エラー（currentPackageIdentifierが必要）となります。

識別子を変更する場合はリクエストボディのpackageIdentifierに変更後の値を指定してください。currentPackageIdentifier（クエリ。対象を指定するための現在値）とボディのpackageIdentifier（変更後の値）は役割が異なります。displayName・packageIdentifier（ボディ）はそれぞれ独立して省略可能で、指定した項目のみ更新されます。ただし両方とも省略した場合、更新する項目がないため400エラーとなります。

注意事項

  • 本APIは、実行元のアプリケーションだけでなく、同一デベロッパーに属する全アプリケーションのソフトウェアのpackageの表示名・識別子を更新します。
  • 表示名を削除する場合は、displayNameにnullを指定してください。
Authorizations:
cwsAuthmimiAuth
path Parameters
applicationId
required
string

アプリケーションID

package
required
string

ソフトウェアのパッケージ名

query Parameters
currentPackageIdentifier
string

パッケージの識別子（現在値）。同名のpackageが複数登録されている場合に対象を指定するために使用する（省略可能）。省略した場合、対象が1件のみであればそのまま処理され、複数存在する場合は422エラーとなる。更新対象ではなく、あくまで対象パッケージを選ぶための現在値（変更後の値はリクエストボディのpackageIdentifierで指定する）。

header Parameters
Authorization
string
Request Body schema: application/json
required

更新する表示名・識別子

displayName
string or null [ 1 .. 255 ] characters

ソフトウェアの表示名。一意識別子であるpackageとは別に、ユーザー向けの表示・管理用途で使用する名称です。nullを指定した場合、表示名を削除します。省略可能（省略した場合、表示名は変更しない）。

packageIdentifier
string [ 1 .. 255 ] characters ^[A-Za-z0-9_.-]+$

変更後のパッケージの識別子（省略可能。省略した場合、識別子は変更しない）。同一のpackage内で他のパッケージが使用していない値を指定する必要がある。対象パッケージの特定には、クエリパラメータのcurrentPackageIdentifier（対象特定用の現在値）を使用する。使用できる文字は半角英数字・_・-・.のみ（クエリパラメータ・パスパラメータでエンコードなしに使用できる範囲）。

Responses

Request samples

Content type
application/json
{
  • "displayName": "更新されたアプリケーション",
  • "packageIdentifier": "76bbd513-767b-4574-956d-61c117e7c948"
}

Response samples

Content type
application/json
{
  • "package": "string",
  • "packageIdentifier": "76bbd513-767b-4574-956d-61c117e7c948",
  • "displayName": "サンプルアプリケーション",
  • "registerDate": "2025-11-28T14:15:22.123456",
  • "updateDate": "2025-11-28T14:15:22.123456"
}

登録したソフトウェア（パッケージ）の情報を削除する

登録したソフトウェアのpackageを削除します。

注意事項

本APIは、実行元のアプリケーションだけでなく、同一デベロッパーに属する全アプリケーションのソフトウェアのpackageを削除します。

ソフトウェアのpackageを削除するには、ソフトウェアのpackageに登録されている情報が、全て削除されている必要があります。 以下を全て削除してから、実行してください。

同名のpackageが複数登録されている場合、packageIdentifierで対象を指定してください。packageIdentifierを省略した場合、対象が1件のみであればそのまま処理され、複数存在する場合は422エラー（packageIdentifierが必要）となります。

Authorizations:
cwsAuthmimiAuth
path Parameters
applicationId
required
string

アプリケーションID

package
required
string

ソフトウェアのパッケージ名

query Parameters
packageIdentifier
string

パッケージの識別子。同名のpackageが複数登録されている場合に対象を指定するために使用する（省略可能）。省略した場合、対象が1件のみであればそのまま処理され、複数存在する場合は422エラーとなる。

header Parameters
Authorization
string

Responses

Response samples

Content type
application/json
{
  • "reason": "validation error.",
  • "details": [
    ]
}

指定したソフトウェア（パッケージ）のバージョンの一覧を取得する

指定したソフトウェアのバージョンを一覧で取得します。 存在しないソフトウェアのpackageを指定した場合は、エラーとなります。

同名のpackageが複数登録されている場合、packageIdentifierで対象を指定してください。packageIdentifierを省略した場合、対象が1件のみであればそのまま処理され、複数存在する場合は422エラー（packageIdentifierが必要）となります。

注意事項

本APIは、実行元のアプリケーションだけでなく、同一デベロッパーに属する全アプリケーションのソフトウェアのバージョンを取得します。

Authorizations:
cwsAuthmimiAuth
path Parameters
applicationId
required
string

アプリケーションID

package
required
string

ソフトウェアのパッケージ名

query Parameters
packageIdentifier
string

パッケージの識別子。同名のpackageが複数登録されている場合に対象を指定するために使用する（省略可能）。省略した場合、対象が1件のみであればそのまま処理され、複数存在する場合は422エラーとなる。

header Parameters
Authorization
string

Responses

Response samples

Content type
application/json
{
  • "versionList": [
    ]
}

指定したソフトウェア（パッケージ）のバージョンを登録する

デバイスに配信するためのソフトウェアに、バージョンを登録します。

同名のpackageが複数登録されている場合、packageIdentifierで対象を指定してください。packageIdentifierを省略した場合、対象が1件のみであればそのまま処理され、複数存在する場合は422エラー（packageIdentifierが必要）となります。

注意事項

  • バージョンは、セマンティックバージョニングに基づく名称を使用することを推奨します。
  • 同一のソフトウェアに対して、同じバージョンを重複して登録することはできません。
Authorizations:
cwsAuthmimiAuth
path Parameters
applicationId
required
string

アプリケーションID

package
required
string

ソフトウェアのパッケージ名

header Parameters
Authorization
string
Request Body schema: application/json
required

登録するバージョン

packageIdentifier
string

登録先のパッケージの識別子。同名のpackageが複数登録されている場合に対象を指定するために使用する（省略可能）。省略した場合、対象が1件のみであればそのまま処理され、複数存在する場合は422エラーとなる。

version
required
string non-empty

ソフトウェアのバージョン。セマンティックバージョニングに基づく名称を使用することを推奨します（例:1.0.0）。

description
string [ 1 .. 255 ] characters

バージョンの説明

Responses

Request samples

Content type
application/json
{
  • "packageIdentifier": "76bbd513-767b-4574-956d-61c117e7c948",
  • "version": "1.0.0",
  • "description": "初期リリース版"
}

Response samples

Content type
application/json
{
  • "package": "string",
  • "version": "string",
  • "description": "初期リリース版",
  • "registerDate": "2025-11-28T14:15:22.123456",
  • "updateDate": "2025-11-28T14:15:22.123456"
}

指定したソフトウェア（パッケージ）のバージョンの説明を更新する

指定したバージョンの説明を更新します。

同名のpackageが複数登録されている場合、packageIdentifierで対象を指定してください。packageIdentifierを省略した場合、対象が1件のみであればそのまま処理され、複数存在する場合は422エラー（packageIdentifierが必要）となります。

注意事項

  • 本APIは、実行元のアプリケーションだけでなく、同一デベロッパーに属する全アプリケーションのソフトウェアのバージョンの説明を更新します。
  • 説明を削除する場合は、descriptionにnullを指定してください。
Authorizations:
cwsAuthmimiAuth
path Parameters
applicationId
required
string

アプリケーションID

package
required
string

ソフトウェアのパッケージ名

version
required
string

ソフトウェアのバージョン

query Parameters
packageIdentifier
string

パッケージの識別子。同名のpackageが複数登録されている場合に対象を指定するために使用する（省略可能）。省略した場合、対象が1件のみであればそのまま処理され、複数存在する場合は422エラーとなる。

header Parameters
Authorization
string
Request Body schema: application/json
required

更新する説明

description
required
string or null [ 1 .. 255 ] characters

バージョンの説明。nullを指定した場合、説明を削除します。

Responses

Request samples

Content type
application/json
{
  • "description": "バグ修正版"
}

Response samples

Content type
application/json
{
  • "package": "string",
  • "version": "string",
  • "description": "初期リリース版",
  • "registerDate": "2025-11-28T14:15:22.123456",
  • "updateDate": "2025-11-28T14:15:22.123456"
}

指定したソフトウェア（パッケージ）のバージョンを削除する

指定したソフトウェアから、指定したバージョンを削除します。

注意事項

同名のpackageが複数登録されている場合、packageIdentifierで対象を指定してください。packageIdentifierを省略した場合、対象が1件のみであればそのまま処理され、複数存在する場合は422エラー（packageIdentifierが必要）となります。

Authorizations:
cwsAuthmimiAuth
path Parameters
applicationId
required
string

アプリケーションID

package
required
string

ソフトウェアのパッケージ名

version
required
string

ソフトウェアのバージョン

query Parameters
packageIdentifier
string

パッケージの識別子。同名のpackageが複数登録されている場合に対象を指定するために使用する（省略可能）。省略した場合、対象が1件のみであればそのまま処理され、複数存在する場合は422エラーとなる。

header Parameters
Authorization
string

Responses

Response samples

Content type
application/json
{
  • "reason": "validation error.",
  • "details": [
    ]
}

ソフトウェアのバイナリアップロード状態を取得する

指定したソフトウェアのバージョンのバイナリの状態を取得します。

同名のpackageが複数登録されている場合、packageIdentifierで対象を指定してください。packageIdentifierを省略した場合、対象が1件のみであればそのまま処理され、複数存在する場合は422エラー（packageIdentifierが必要）となります。

注意事項

本APIは、実行元のアプリケーションだけでなく、同一デベロッパーに属する全アプリケーションのソフトウェアのバイナリの状態を取得します。

Authorizations:
cwsAuthmimiAuth
path Parameters
applicationId
required
string

アプリケーションID

package
required
string

ソフトウェアのパッケージ名

version
required
string

ソフトウェアのバージョン

query Parameters
packageIdentifier
string

パッケージの識別子。同名のpackageが複数登録されている場合に対象を指定するために使用する（省略可能）。省略した場合、対象が1件のみであればそのまま処理され、複数存在する場合は422エラーとなる。

header Parameters
Authorization
string

Responses

Response samples

Content type
application/json
{
  • "exist": true,
  • "size": 1234567,
  • "uploadDate": "2025-11-28T14:15:22.123"
}

ソフトウェアのバイナリを削除する

指定したソフトウェアのバージョンのバイナリを削除します。

注意事項

  • 本APIは、実行元のアプリケーションだけでなく、同一デベロッパーに属する全アプリケーションのソフトウェアのバイナリを削除します。
  • 配信が開始されている状態で、バイナリを削除するとソフトウェアをすぐにアップデートさせる で400エラーとなります。
  • バイナリを削除後、端末で該当のソフトウェアのアップデートが行われると、アップデートが失敗します。

同名のpackageが複数登録されている場合、packageIdentifierで対象を指定してください。packageIdentifierを省略した場合、対象が1件のみであればそのまま処理され、複数存在する場合は422エラー（packageIdentifierが必要）となります。

Authorizations:
cwsAuthmimiAuth
path Parameters
applicationId
required
string

アプリケーションID

package
required
string

ソフトウェアのパッケージ名

version
required
string

ソフトウェアのバージョン

query Parameters
packageIdentifier
string

パッケージの識別子。同名のpackageが複数登録されている場合に対象を指定するために使用する（省略可能）。省略した場合、対象が1件のみであればそのまま処理され、複数存在する場合は422エラーとなる。

header Parameters
Authorization
string

Responses

Response samples

Content type
application/json
{
  • "reason": "validation error.",
  • "details": [
    ]
}

ソフトウェアのバイナリをアップロードするためのURLを作成する

指定したソフトウェアのバージョンに対して、対応するバイナリをアップロードするためのURLを発行します。 このURLは Amazon S3 の presigned URL です。このAPIではファイル自体のアップロードは行いません。返却されたURLを使用して、クライアントから直接アップロードしてください。

同名のpackageが複数登録されている場合、packageIdentifierで対象を指定してください。packageIdentifierを省略した場合、対象が1件のみであればそのまま処理され、複数存在する場合は422エラー（packageIdentifierが必要）となります。

注意事項

  • マルチパートアップロードには対応しておりません。
  • 発行したAmazon S3 presigned URLへアップロードを行う際、Content-Typeには application/vnd.android.package-archiveを指定することを推奨します。
  • アップロード可能なソフトウェアのpackageのファイルサイズは、5GBまでです。
Authorizations:
cwsAuthmimiAuth
path Parameters
applicationId
required
string

アプリケーションID

package
required
string

ソフトウェアのパッケージ名

version
required
string

ソフトウェアのバージョン

header Parameters
Authorization
string
Request Body schema: application/json
optional
packageIdentifier
string

パッケージの識別子。同名のpackageが複数登録されている場合に対象を指定するために使用する（省略可能）。省略した場合、対象が1件のみであればそのまま処理され、複数存在する場合は422エラーとなる。

Responses

Request samples

Content type
application/json
{
  • "packageIdentifier": "76bbd513-767b-4574-956d-61c117e7c948"
}

Response samples

Content type
application/json
{
  • "urlList": [
    ]
}

ソフトウェアのバイナリをダウンロードするためのURLを作成する

指定したソフトウェアバージョンのアップロード済みのバイナリを、ダウンロードするためのURLを発行します。 このURLは Amazon S3 の presigned URL です。このAPIではファイル自体のダウンロードは行いません。返却されたURLを使用して、クライアントから直接ダウンロードしてください。

同名のpackageが複数登録されている場合、packageIdentifierで対象を指定してください。packageIdentifierを省略した場合、対象が1件のみであればそのまま処理され、複数存在する場合は422エラー（packageIdentifierが必要）となります。

注意事項

  • 本APIは、実行元のアプリケーションだけでなく、同一デベロッパーに属する全アプリケーションのソフトウェアのバイナリを対象とします。
  • 発行したURLの有効期限は3600秒です。
  • system packageと、ファームウェアのバイナリはダウンロードできません（403エラー）。
  • バイナリがアップロードされていない場合は、404エラーとなります。
Authorizations:
cwsAuthmimiAuth
path Parameters
applicationId
required
string

アプリケーションID

package
required
string

ソフトウェアのパッケージ名

version
required
string

ソフトウェアのバージョン

query Parameters
packageIdentifier
string

パッケージの識別子。同名のpackageが複数登録されている場合に対象を指定するために使用する（省略可能）。省略した場合、対象が1件のみであればそのまま処理され、複数存在する場合は422エラーとなる。

header Parameters
Authorization
string

Responses

Response samples

Content type
application/json
{
  • "downloadUrl": "string",
  • "startTimestamp": 1790000000,
  • "endTimestamp": 1790003600,
  • "expireIn": 3600,
  • "fileName": "com.example.myapp_1.0.0.apk",
  • "size": 1234567,
  • "uploadDate": "2025-11-28T14:15:22.123"
}

ソフトウェアをアップロードするためのURLを作成する

本APIは、以下を行います。

  • ソフトウェア（パッケージ）の登録
  • ソフトウェアのバージョンの登録
  • ソフトウェアの配信開始
  • ソフトウェアをアップロードするためのURL（Amazon S3 presigned URL）の作成

すでに該当のデータが存在する場合、パッケージ登録・バージョン登録・配信開始は、それぞれ行われません。アップロード用URLの作成は、データの存在有無に関わらず必ず行います。

また、同じpackage名を持つソフトウェアを、別ソフトウェアとして登録できます。その場合、packageIdentifierでソフトウェアを区別します。

  • packageIdentifierを指定した場合: 指定したpackage＋packageIdentifierの組み合わせで新規登録します。すでに指定した組み合わせのソフトウェアが存在する場合は、新規登録せず、既存のソフトウェアに対してバージョン追加・URL発行を行います。
  • packageIdentifierを省略した場合: 自分が保有する同じpackage名のソフトウェアが0件なら新規登録（packageIdentifierはランダムな値が自動的に割り当てられます）、1件なら既存パッケージへのバージョン追加、2件以上の場合は422エラーとなります。allowDuplicate: trueを指定した場合は、同名packageの件数に関わらず、必ず新規登録します。

ただし、ai.fdで始まるpackageは受け付けません。

現状はmulti part に対応しておりません。

発行したAmazon S3 presigned URLへアップロードを行う際、Content-Typeには application/vnd.android.package-archiveを指定することを推奨します。

配信可能なソフトウェアとバージョンの一覧を取得するAPIのソート機能は、セマンティック・バージョニングを前提としています。そのため、パッケージのバージョニングにはセマンティック・バージョニングの利用を推奨いたします。 アップロード可能なソフトウェアのpackageのファイルサイズは、5GBまでです。

Authorizations:
cwsAuthmimiAuth
path Parameters
applicationId
required
string

アプリケーションID

header Parameters
Authorization
string
Request Body schema: application/json
required
  • package と version は ソフトウェアをすぐにアップデートさせる で指定するものと同じ値を指定してください。
  • packageIdentifier は省略可能です。省略した場合、対象が1件のみであればそのまま処理され、複数存在する場合は422エラーとなります。新規登録の場合、省略するとランダムな値が自動的に割り当てられます。
  • fileSize はuploadする予定のバイナリのサイズを設定してください。
  • allowDuplicate は省略可能です（デフォルトfalse）。packageIdentifierを省略した場合に本パラメータにtrueを指定すると、必ず新規パッケージとして登録されます。パッケージの新規登録をしたくない場合は、falseを指定するか、このパラメータを省略してください。
package
string

Upload対象のapplication package

packageIdentifier
string [ 1 .. 255 ] characters ^[A-Za-z0-9_.-]+$

パッケージの識別子。同名のpackageが複数登録されている場合に対象を指定するために使用する（省略可能）。省略した場合、対象が1件のみであればそのまま処理され、複数存在する場合は422エラーとなる。新規登録の場合、省略するとランダムな値（UUID等）が自動的に割り当てられる。使用できる文字は半角英数字・_・-・.のみ（クエリパラメータ・パスパラメータでエンコードなしに使用できる範囲）。

version
string

Upload対象のapplication の versionCode

fileSize
integer <int64> >= 1

Upload対象のapplication の fileSize(byte)。1以上の値を指定。

allowDuplicate
boolean
Default: false

packageIdentifierを省略した場合に本パラメータにtrueを指定すると、必ず新規パッケージとして登録されます。パッケージの新規登録をしたくない場合は、falseを指定するか、このパラメータを省略してください。

Responses

Request samples

Content type
application/json
{
  • "package": "ai.fd.thinklet.app.launcher",
  • "packageIdentifier": "76bbd513-767b-4574-956d-61c117e7c948",
  • "version": "1.0.0",
  • "fileSize": 123456789
}

Response samples

Content type
application/json
{}

配信可能なソフトウェアとバージョンの一覧を取得する

概要

配信可能なソフトウェアとバージョンの一覧を取得します。

一覧のソート順は、ソフトウェアのpackageが昇順、バージョンは降順となります。 セマンティック・バージョニングで付与されたバージョン以外は、意図しないソート結果となる場合があります。

systemPackagesは、CWS からデフォルトで配信されているソフトウェアのpackageの一覧となります。この一覧はページネーション（offset, limit）の対象外です。 systemPackagesでは、各ソフトウェアのpackageについて、最大で3つの最新バージョンを取得します。

同名のpackageを複数登録している場合、レスポンスの各アイテムに含まれるpackageIdentifierで区別してください。packageIdentifierをクエリパラメータで指定すると、packageと同様にその値で絞り込むことができます。

mode=latestは、package（パッケージ名）ではなくpackage＋packageIdentifierの組み合わせごとに最新バージョンを取得します。

Authorizations:
cwsAuthmimiAuth
path Parameters
applicationId
required
string

アプリケーションID

query Parameters
package
string

一覧を取得したいソフトウェアのパッケージ名。未指定の場合、全てのソフトウェアのpackageを取得する。

packageIdentifier
string

パッケージの識別子。同名のpackageが複数登録されている場合に対象を絞り込むために使用する（省略可能）。packageと同様に単純な絞り込み条件であり、省略した場合は絞り込みを行わない。

mode
string

取得する一覧のモード。latestを指定した場合、package＋packageIdentifierの組み合わせ（パッケージ実体）ごとに最新バージョンのみを取得する。未指定の場合は、対象のバージョンを全件取得する。

offset
integer

userPackagesの開始位置。未指定の場合は、0番目から取得する。

limit
integer

userPackagesの1ページあたりの取得件数。未指定の場合、100件取得する。

header Parameters
Authorization
string

Responses

Response samples

Content type
application/json
{
  • "systemPackages": [
    ],
  • "userPackages": [
    ],
  • "totalCount": 100,
  • "offset": 0,
  • "limit": 2
}

ソフトウェアの配信状態を取得する

指定したソフトウェアのバージョンの配信状態を取得します。

同名のpackageが複数登録されている場合、packageIdentifierで対象を指定してください。packageIdentifierを省略した場合、対象が1件のみであればそのまま処理され、複数存在する場合は422エラー（packageIdentifierが必要）となります。

注意事項

  • 本APIは、実行元のアプリケーションだけでなく、同一デベロッパーに属する全アプリケーションのソフトウェアの配信状態を取得します。
  • 2026年3月26日以前に配信を開始したバージョンのdistributionDateは、2026年3月26日となっています。
Authorizations:
cwsAuthmimiAuth
path Parameters
applicationId
required
string

アプリケーションID

package
required
string

ソフトウェアのパッケージ名

version
required
string

ソフトウェアのバージョン

query Parameters
packageIdentifier
string

パッケージの識別子。同名のpackageが複数登録されている場合に対象を指定するために使用する（省略可能）。省略した場合、対象が1件のみであればそのまま処理され、複数存在する場合は422エラーとなる。

header Parameters
Authorization
string

Responses

Response samples

Content type
application/json
{
  • "package": "com.example.myapp",
  • "version": "1.0.0",
  • "distributable": true,
  • "distributionDate": "2026-02-12T10:30:45.123456"
}

ソフトウェアの配信を開始する

指定したソフトウェアのバージョンの配信を開始します。配信を開始したバージョンのみ、デバイスへのソフトウェアアップデートを実行できます。この設定は、配信の開始（POST）／配信の停止（DELETE）で操作します。

同名のpackageが複数登録されている場合、packageIdentifierで対象を指定してください。packageIdentifierを省略した場合、対象が1件のみであればそのまま処理され、複数存在する場合は422エラー（packageIdentifierが必要）となります。

注意事項

Authorizations:
cwsAuthmimiAuth
path Parameters
applicationId
required
string

アプリケーションID

package
required
string

ソフトウェアのパッケージ名

version
required
string

ソフトウェアのバージョン

header Parameters
Authorization
string
Request Body schema: application/json
optional
packageIdentifier
string

パッケージの識別子。同名のpackageが複数登録されている場合に対象を指定するために使用する（省略可能）。省略した場合、対象が1件のみであればそのまま処理され、複数存在する場合は422エラーとなる。

Responses

Request samples

Content type
application/json
{
  • "packageIdentifier": "76bbd513-767b-4574-956d-61c117e7c948"
}

Response samples

Content type
application/json
{
  • "package": "com.example.myapp",
  • "version": "1.0.0",
  • "distributable": true,
  • "distributionDate": "2026-02-12T10:30:45.123456"
}

ソフトウェアの配信を停止する

指定したソフトウェアのバージョンの配信を停止します。 この操作は、すでに端末にインストールされているソフトウェアには影響しません。

同名のpackageが複数登録されている場合、packageIdentifierで対象を指定してください。packageIdentifierを省略した場合、対象が1件のみであればそのまま処理され、複数存在する場合は422エラー（packageIdentifierが必要）となります。

注意事項

本APIは、実行元のアプリケーションだけでなく、同一デベロッパーに属する全アプリケーションのソフトウェアのpackageを対象に、配信を停止します。

Authorizations:
cwsAuthmimiAuth
path Parameters
applicationId
required
string

アプリケーションID

package
required
string

ソフトウェアのパッケージ名

version
required
string

ソフトウェアのバージョン

query Parameters
packageIdentifier
string

パッケージの識別子。同名のpackageが複数登録されている場合に対象を指定するために使用する（省略可能）。省略した場合、対象が1件のみであればそのまま処理され、複数存在する場合は422エラーとなる。

header Parameters
Authorization
string

Responses

Response samples

Content type
application/json
{
  • "reason": "validation error.",
  • "details": [
    ]
}

ソフトウェアをすぐにアップデートさせる

指定したアプリケーションを指定したデバイスにインストールします。

配信設定（ソフトウェアの配信を開始する）が行われている package/version のみを対象とします。ただし、CWS からデフォルトで配信されているソフトウェア（systemPackage）は、配信設定の有無に関わらず対象になります。

同名の package が複数登録されている場合、packageIdentifier で対象を指定してください。packageIdentifier を省略した場合、対象が1件のみであればそのまま処理され、複数存在する場合は422エラー（packageIdentifierが必要）となります。

Authorizations:
cwsAuthmimiAuth
path Parameters
deviceId
required
string

THINKLETのIMEI

applicationId
required
string

アプリケーションID

header Parameters
Authorization
string
Request Body schema: application/json
package
required
string

ソフトウェアのパッケージ名

packageIdentifier
string

パッケージの識別子。同名のpackageが複数登録されている場合に対象を指定するために使用する（省略可能）。省略した場合、対象が1件のみであればそのまま処理され、複数存在する場合は422エラーとなる。

version
required
string

ソフトウェアのバージョン

Responses

Request samples

Content type
application/json
{
  • "package": "ai.fd.thinklet.app.launcher",
  • "packageIdentifier": "76bbd513-767b-4574-956d-61c117e7c948",
  • "version": "0.2.2"
}

Response samples

Content type
application/json
{
  • "transactionId": 1
}

配信可能なファームウェアとバージョンの一覧を取得する

概要

配信可能なファームウェアとバージョンの一覧を取得します。

一覧のソート順は、ファームウェアが昇順、バージョンは降順となります。

Authorizations:
cwsAuthmimiAuth
path Parameters
applicationId
required
string

アプリケーションID

header Parameters
Authorization
string

Responses

Response samples

Content type
application/json
{
  • "firmwareVersions": [
    ]
}

ファームウェアをすぐにアップデートさせる

指定したデバイスのファームウェアを更新させます。

Authorizations:
cwsAuthmimiAuth
path Parameters
deviceId
required
string

THINKLETのIMEI

applicationId
required
string

アプリケーションID

header Parameters
Authorization
string
Request Body schema: application/json
version
required
string

ファームウェアのバージョン

Responses

Request samples

Content type
application/json
{
  • "version": "1.0.0"
}

Response samples

Content type
application/json
{
  • "transactionId": 1
}

Operation

Operation Apis

デバイスの初期化

指定したデバイスを初期化します。

このAPIを実行するとデバイスのデータが全て消え、出荷時の状態となります。

初期化されたデバイスは ソフトウェアをすぐにアップデートさせる でインストールされたアプリも削除されているため、再度APIを呼び出してインストールしてください。

Authorizations:
cwsAuthmimiAuth
path Parameters
applicationId
required
string

アプリケーションID

deviceId
required
string

THINKLETのIMEI

header Parameters
Authorization
string

Responses

Response samples

Content type
application/json
{
  • "transactionId": 1
}

デバイスのシャットダウン

指定したデバイスをシャットダウンします。

このAPIはオンライン状態のデバイスにのみ実行できます。 デバイスがオフラインの場合は 409 Conflict を返します。

本APIは、下記バージョン以降のFwに対応しています。

  • Fw 15.000.0以上（mdmclient 3.5.0以上）

上記バージョン未満のFwがインストールされているTHINKLETに対してAPIを実行した場合は 422 Unprocessable Entity を返します。

デバイスがトランザクションを受信する前にオフラインになった場合、そのトランザクションは自動的にキャンセルされます。

Authorizations:
cwsAuthmimiAuth
path Parameters
applicationId
required
string

アプリケーションID

deviceId
required
string

THINKLETのIMEI

header Parameters
Authorization
string

Responses

Response samples

Content type
application/json
{
  • "transactionId": 1
}

デバイスの再起動

指定したデバイスを再起動します。

端末の起動は、デバイス状態変更通知(端末起動状態)を受け取ることで確認ができます。

このAPIはオンライン状態のデバイスにのみ実行できます。 デバイスがオフラインの場合は 409 Conflict を返します。

本APIは、下記バージョン以降のFwに対応しています。

  • Fw 15.000.0以上（mdmclient 3.5.0以上）

上記バージョン未満のFwがインストールされているTHINKLETに対してAPIを実行した場合は 422 Unprocessable Entity を返します。

デバイスがトランザクションを受信する前にオフラインになった場合、そのトランザクションは自動的にキャンセルされます。

Authorizations:
cwsAuthmimiAuth
path Parameters
applicationId
required
string

アプリケーションID

deviceId
required
string

THINKLETのIMEI

header Parameters
Authorization
string

Responses

Response samples

Content type
application/json
{
  • "transactionId": 1
}

言語設定をする

指定したデバイスの言語設定情報を変更します。

概要

本APIはデバイスのOS言語設定を変更することが可能です。

本APIでは Request Body に指定された言語コードが schemas の指定に基づいているかどうかのバリデーションのみを行っているため、リクエストされた言語コードが実際にデバイスに設定されるかどうかはトランザクション結果通知の通知内容を確認するようにしてください。

Authorizations:
cwsAuthmimiAuth
path Parameters
applicationId
required
string

アプリケーションID

deviceId
required
string

THINKLETのIMEI

header Parameters
Authorization
string
Request Body schema: application/json
required

言語設定

Array
string <= 8 characters ^[a-zA-Z0-9!-/:-@\[-`{-~]+

Responses

Request samples

Content type
application/json
[
  • "ja",
  • "en"
]

Response samples

Content type
application/json
{
  • "transactionId": 1
}

LauncherAppへのKey設定

概要

THINKLETの物理キー（left、center、right）の動作設定を変更します。各キーに対して、短押し、長押し、ダブルクリックなどのイベントごとに、アプリの起動などのアクションを指定することができます。

本APIは、THINKLETに備わっている3つの物理キー（left, center, right）の動作設定をリモートから変更するためのものです。

各キーへの「短押し、長押し、ダブルクリック」といった操作に対して、アプリ起動などのアクションを自由に割り当てることができます。

設定には、THINKLET開発者ポータルのキーコンフィグで解説されている、key_config.json と同様の記述ルールを使用します。通常、デバイス側で設定を行う際はファイルを直接配置しますが、本APIを利用することで、ネットワーク経由で同等の設定をデバイスへ送信・適用することが可能です。

Launcher規定のkey_configとフォーマットが異なる場合は本APIでエラーを返却します。

Launcherへの適用が完了した際に、トランザクション結果通知として通知します。

Authorizations:
cwsAuthmimiAuth
path Parameters
applicationId
required
string

アプリケーションID

deviceId
required
string

THINKLETのIMEI

header Parameters
Authorization
string
Request Body schema: application/json
required
  • Key設定の検査内容はLauncher規定の形式・必須Keyが存在するチェックまでとします。
required
Array of objects (KeyConfig)

各Key & ボタン操作の内容列挙

Array
key-name
required
string

対象のkey名。以下のいずれかを指定

  • left
    • ジェスチャセンサに最も近い位置にあるキー
  • center
    • 3つ並んだキーの真ん中にある小さな突起のついたキー
  • right
    • THINKLETロゴに最も近い位置にあるキー
key-event
required
string

イベント発生させるKeyEvent

  • first-pressed
    • ボタンが押下された瞬間に発生するイベント
  • single-released
    • 短押し
  • double-pressed
    • 2回押しの押し始めのイベント
  • double-released
    • 2回押しの2回目に離した時のイベント
  • long-pressed
    • 長押しイベント
  • long-released
    • 長押し（long-pressed）後にボタンが離された時のイベント
required
object (KeyAction)

Responses

Request samples

Content type
application/json
{
  • "key-config": [
    ]
}

Response samples

Content type
application/json
{
  • "transactionId": 1
}

デバイスでコマンドを実行させる

概要

THINKLETデバイス(以下、デバイス）にインストールされたご利用者様のアプリに対して、PackageやActivityを指定し、任意のコマンドを送る API です。 本APIを利用することで、CWS API経由でのアプリ起動などが実現可能です。

本APIは、例えばadbコマンド経由でForegroundServiceを起動する下記コマンドをRemote経由で、実行するイメージとなります。

adb shell am start-foreground-service -n com.example.myapp/.services.MyService

デバイスにご利用者様アプリをインストールする方法は、下記 API を参照ください。

コマンド実行結果の通知について

本APIのリクエスト body で指定した内容をデバイスで実行し、Webhook（トランザクション結果通知(コマンド実行)） で実行結果を通知します。

通知タイミングは下記となり、通知時のトランザクションステータスは processed となります。

  • ご利用者様アプリの呼び出し後
  • ご利用者様アプリからの応答受信後

デバイス向けIF仕様に沿ってご利用者様アプリで対応を行うことで、通知に任意のメッセージを追加することも可能です。

デバイス向けIF仕様については、ご利用者様に個別に提供しております。
ご希望の方は当社にお問い合わせください。

特記事項

  • 本APIでは、下記のような Activity や Service を指定しない Android独自のコマンド各種はサポートしていません。

    • 例えば以下のようなコマンドはサポート外となりますのでご注意ください。
      adb shell am start -a android.intent.action.CALL tel:00000000
    • 仮に上記を実現したい場合は、ご利用者様アプリで上記コマンド内容を実行できるよう開発を行い、本APIを経由して、ご利用者様アプリにコマンドを送信することで実現可能です。

  • 本APIでは、最低限のパラメータチェックのみを実行します.

    • action、package、classpathのいずれも指定されない場合は、連携時にエラー通知を送信します。

requiredパラメータの変更

  • 本APIで、下記パラメータがrequired指定を解除しております。
    • action
    • package
    • classpath
  • 上記required指定解除に伴い、Fwのバージョンによって動作が異なります。

Fw 9.000.0以上 （mdmclient 2.1.1以上）の場合

Fw 8.000.0未満 （mdmclient 2.1.1未満）の場合

  • action、package、classpathの全てが指定されている場合は、正常動作し、アプリ連携時にCWS API Notifications記載のトランザクション結果通知(コマンド実行)を利用して、実行結果を送信します。
  • action、package、classpathの1つでも指定されていない場合は、mdmclientが本変更に対応しておらず、正常に処理できません。
    • 正常に処理できなかった場合、CWS APIの発行したトランザクションが、ステータスpublishedのまま、未完了状態となり、端末の再起動時などに再度処理を実行してしまいます。
    • この場合、下記CWS APIを利用して、トランザクションキャンセル処理を実行してください。
Authorizations:
cwsAuthmimiAuth
path Parameters
applicationId
required
string

アプリケーションID

deviceId
required
string

THINKLETのIMEI

header Parameters
Authorization
string
Request Body schema: application/json
required
  • extras を利用することでご利用者様アプリに対して任意の情報を通知することが可能です。
    • ご利用者様アプリの仕様範疇となるため、内容の正当性をチェックしません。
    • ご利用者様アプリへ送信するIntentに設定するextraのKeyは、本APIで指定するJsonのKeyと対応します。
      • 例えば本APIで、 {"e1":"test"} として指定する場合、デバイスでは、Intent.getString("e1") としてアクセスします。
  • extras で対応する型は以下のとおりです。
    • String
    • Boolean
    • Intger (32ビット符号付き整数データ型)
    • Long (64ビット符号付き整数データ型)
    • Double (64ビット倍精度浮動小数点数データ型)
    • Array
    • Object（Json）
  • extras に指定するJsonの String または Boolean 型については、Json記載通りに解釈し、ご利用者様アプリへ通知します。
    • 文字列としてJsonや、Arrayを指定する場合、取得したStringをJSONObject、JSONArrayを利用してアクセスしてください。
  • extras に指定するJsonの数値型については、取り扱いにご注意下さい。
    • Integer または Long 型については、Integer 型として収まる範囲であれば、Integer型 として取り扱い、収まらない場合は Long型 として取り扱います。
    • それ以外の小数点を持つ数値型は、Double 型として取り扱います。
    • なお、上記のルールは第一階層にのみ適応され、第二階層以降では、数値型はDouble 型 として取り扱います。
  • extras に指定するJsonの Array 及び Object型については、Intent.putSerializable(Key, Value)を行い、ご利用者様アプリへ通知します。
    • 例えば {"exArray": ["string", 123, null, true]}として指定する場合 デバイスでは、下記のようにアクセスします。
      val exArray: List<Any> = intent.getSerializableExtra("exArray") as List<Any>
    • 例えば {"exObject": {"key1":"data1","key2":"data2"}}として指定する場合 デバイスでは、下記のようにアクセスします。
      val exObject: Map<String, Any> = intent.getSerializableExtra("exObject") as Map<String, Any>
package
string [ 1 .. 128 ] characters

ご利用者様アプリのpackage名

classpath
string [ 1 .. 256 ] characters

ご利用者様アプリのclasspath

action
string [ 1 .. 128 ] characters

ご利用者様アプリのaction

launchType
required
string

動作のタイプ

  • activity
  • service
  • foregroundservice
  • broadcast
extras
object (json)
  • ご利用者様アプリに対して追加でデータ連携したい情報などあればJson形式で指定
  • 最大バイト数は4096byte、超える場合はエラー

Responses

Request samples

Content type
application/json
{
  • "package": "packagename",
  • "classpath": "packagename.MainActivity",
  • "action": "packagename.action",
  • "launchType": "activity",
  • "extras": {
    }
}

Response samples

Content type
application/json
{
  • "transactionId": 1
}

ソフトウェアをアンインストールする

指定したソフトウェアをデバイスからアンインストールします。

パッケージ名は下記のAPIから確認してください。

本APIは、下記バージョン以降に対応しています。

  • Fw 13.000.0以上（mdmclient 3.4.0以上, deviceowner 1.4.0以上）
Authorizations:
cwsAuthmimiAuth
path Parameters
applicationId
required
string

アプリケーションID

deviceId
required
string

THINKLETのIMEI

package
required
string

パッケージ名

header Parameters
Authorization
string

Responses

Response samples

Content type
application/json
{
  • "transactionId": 1
}

Transaction

Transaction Apis

トランザクションの一覧を取得する

概要

アプリケーションIDに属するトランザクションを全て取得します。

クエリパラメータで、取得するトランザクションの条件を指定することができます。

注意事項

2026年5月リリースより前に発行されたトランザクションは、requestBody・transactionResult が null となります。

Authorizations:
cwsAuthmimiAuth
path Parameters
applicationId
required
string

アプリケーションID

query Parameters
deviceId
string

THINKLETのIMEI番号

completionStatus
string
Enum: "uncompleted" "completed" "canceled"

トランザクションの完了状態、以下いずれかの値を指定できる。

  • uncompleted : 未完了
  • completed: 処理済み
  • canceled : キャンセル済み
transactionResult
string
Enum: "success" "failure"

トランザクション結果での絞り込み。未指定の場合は絞り込みを行わない。

  • success : 正常に完了したトランザクションを取得する

  • failure : 失敗またはキャンセルされたトランザクションを取得する

    次の組み合わせは指定できない。

    • completionStatus=uncompleted とtransactionResultの組み合わせ（処理中のトランザクションには結果が存在しない）
    • completionStatus=canceled かつ transactionResult=success の組み合わせ（キャンセルされたトランザクションは failure となる）
order
string
Enum: "asc" "desc"

ソート順。未指定の場合は、昇順(asc)となる。

sortBy
string
Enum: "transactionId" "deviceId" "transactionStatus" "operationId"

ソート順を決める要素。未指定の場合は、transactionId順となる。

perPage
number [ 1 .. 100 ]

取得するトランザクションの件数。未指定の場合は、該当のトランザクションを全て取得する。perPage 指定時に page が指定されていない場合エラーとなる。

page
number >= 1

取得するトランザクションのページ数。page 指定時に perPage が指定されていない場合エラーとなる。

header Parameters
Authorization
string

Responses

Response samples

Content type
application/json
{
  • "transactions": [
    ],
  • "parameters": {
    }
}

トランザクションをキャンセルする

概要

deviceIdに紐づく未処理のトランザクションをキャンセルします。

トランザクションステータスのキャンセル可能範囲について

キャンセル可能範囲一覧

キャンセル可能な条件に合致したトランザクションが複数あった場合、全てキャンセルされます。

トランザクションステータス THINKLET端末の通信状態 キャンセル可能/不可能
created - 可能
published 不可能 可能
可能 不可能
accepted - 不可能
processed - 不可能

publishedの場合について

トランザクションステータスがpublishedの場合は、THINKLET端末の通信状態により状態が変わります。

  • THINKLET端末が通信不可の場合（キャンセル可能）

    • THINKLET端末の接続を待ち、配信待機状態となる。
      • トランザクションステータスは、publishedのままとなる。
    • APIは配信待機しているトランザクションをキャンセル可能です。

  • THINKLET端末が通信可能の場合（キャンセル不可能）

    • THINKLET端末へ即時配信され、処理が開始される。
      • 処理が開始された段階で、トランザクションステータスはpublished->acceptedへ更新される。
    • APIはTHINKLET端末にトランザクションが配信されてしまっているので、キャンセル不可能です。
Authorizations:
cwsAuthmimiAuth
path Parameters
applicationId
required
string

アプリケーションID

deviceId
required
string

THINKLETのIMEI

header Parameters
Authorization
string

Responses

Response samples

Content type
application/json
{
  • "canceledTransactions": [
    ]
}

トランザクションの情報を取得する

概要

アプリケーションIDに紐づくトランザクションの情報を取得します。

2024年5月以降にキャンセルしたトランザクションは、transactionStatusがcanceledとなります。
2024年5月より前にキャンセルしたトランザクションのtransactionStatusはprocessedとなります。

注意事項

2026年5月リリースより前に発行されたトランザクションは、requestBody・transactionResult・transactionResultEvent が null となります。

Authorizations:
cwsAuthmimiAuth
path Parameters
applicationId
required
string

アプリケーションID

transactionId
required
string

トランザクションID

header Parameters
Authorization
string

Responses

Response samples

Content type
application/json
Example
{
  • "transactionId": 1,
  • "transactionStatus": "processed",
  • "transactionResult": "success",
  • "transactionResultEvent": {
    },
  • "operationId": "post-v1-applications-devices",
  • "deviceId": "123456789023421",
  • "requestBody": {
    },
  • "createdAt": "2024-06-01T09:00:00.000000",
  • "updatedAt": "2024-06-01T09:00:05.000000"
}

CommunicationService

Communication Service Apis

WebRTCエンドポイント取得

WebRTC接続用のエンドポイントとチャネルIDを取得します。 バージョンを指定しなかった場合、利用可能なSoraのバージョンを取得で isDefault = True となっているバージョンのSoraを利用するものとしてエンドポイント・チャネルIDが返却されます。

Authorizations:
cwsAuthmimiAuth
path Parameters
applicationId
required
string

アプリケーションID

header Parameters
Authorization
string
Request Body schema: application/json
soraVersion
string

Soraのバージョン。利用可能なSoraのバージョンを取得にて取得したバージョンを指定する

Responses

Request samples

Content type
application/json
{
  • "soraVersion": "string"
}

Response samples

Content type
application/json
{
  • "endpointUrl": "wss://sora01.sample.co.jp/signaling",
  • "channelId": "sgQj8vstE6_202012251632000"
}

利用可能なSoraのバージョンを取得

現在稼働中のWebRTCサーバーのSoraバージョン一覧を取得します。 バージョンは降順でソートされます。

稼働中のWebRTCサーバーにおいては、isDefault = True のものがデフォルトとして利用されます。

Authorizations:
cwsAuthmimiAuth
path Parameters
applicationId
required
string

アプリケーションID

header Parameters
Authorization
string

Responses

Response samples

Content type
application/json
{
  • "soraVersions": [
    ]
}

Billing

Billing Apis

プラン情報と映像通信の利用実績を取得する

概要

アプリケーションIDに紐づくプラン情報・デバイスの映像通信の利用実績を取得します。

利用実績は、固定プラン・従量プラン問わず、映像通信の利用実績のあるデバイスを対象に集計した結果となります。

利用時間の総計を計算した後に、1時間未満の端数を切り上げて返します。(e.g. 利用時間の総計が14時間1ミリ秒の場合、15時間になります)

指定した年月の月初から月末までのプラン情報及び、利用実績を返却します。

  • 未来の年月を指定した場合、適用予定のプラン情報が取得できます。 （固定プランの申込みのないデバイスのプラン情報は取得できません。）
  • 過去の年月を指定した場合、その年月に適用されていたプランと利用実績が取得できます。
  • 現在の年月を指定した場合、最新のプラン情報・利用実績・アクティベート数が取得できます。
  • アクティベート数には transactionStatus が processed(トランザクション処理済み)に至っていないデバイスも含みます。

固定プランの申込みのないデバイスで、指定した年月に利用実績がない場合は、プラン情報と利用実績の取得はできません。

Authorizations:
cwsAuthmimiAuth
path Parameters
applicationId
required
string

アプリケーションID

query Parameters
month
required
number [ 1 .. 12 ]

利用実績を取得したい月

year
required
number >= 2022

利用実績を取得したい年

header Parameters
Authorization
string

Responses

Response samples

Content type
application/json
Example
{
  • "numberOfDevices": 3,
  • "activateDevices": 2,
  • "devices": [
    ],
  • "others": {
    }
}