第6章 デバイス API

6.1. デバイスの一覧表示

6.1.1. 説明

プラットフォームに対して認証されたデバイスの一覧を取得します。

6.1.2. エンドポイント

  • URI: /box/srv/1.1/admin/device/list
  • メソッド: POST

6.1.3. リクエストボディー

{}

6.1.4. レスポンスボディー

6.1.4.1. 成功

{
  "status": "ok",
  "count": <total device count>,
  "list" : [
    {
      "guid": "<device_global_unique_id>",
      "fields": {
        "cuid": "<id_assigned_by_device>",
        "name": "<Friendly_name_of_device>",
        "disabled": true|false, /* Is this device currently blocked from logging in */
        "blacklisted": true|false /* Should data be purged from apps the next time the device authenticates */
      }
    },
    ...
  ]
}

6.1.4.2. エラー

{
  "status": "error",
  "message": "<error_message>"
}

6.2. デバイスの読み込み

6.2.1. 説明

ID に基づいて特定デバイスの詳細を読み込みます。

6.2.2. エンドポイント

  • URI: /box/srv/1.1/admin/device/read
  • メソッド: POST

6.2.3. リクエストボディー

{
  "cuid": "<id_assigned_by_device>"
}

6.2.4. レスポンスボディー

6.2.4.1. 成功

{
  "status": "ok",
  "guid": "<global_unique_id>",
  "fields": {
    "cuid": "<id_assigned_by_device>",
    "name": "<Friendly_name_of_device>",
    "disabled": true|false, /* Is this device currently blocked from logging in */
    "blacklisted": true|false /* Should data be purged from apps the next time the device authenticates */
  }
}

6.2.4.2. エラー

{
  "status": "error",
  "message": "<error_message>"
}

6.3. デバイスの更新

6.3.1. 説明

GUID に基づいて特定デバイスの詳細を更新します。

6.3.2. エンドポイント

  • URI: /box/srv/1.1/admin/device/update
  • メソッド: POST

6.3.3. リクエストボディー

{
  "cuid": "<id_assigned_by_device>",
  "name": "<Friendly_name_of_device>",  /* Optional */
  "disabled": true|false   /* Optional - DEFAULT=false - Is this device currently blocked from logging in */
  "blacklisted": true|false /* Optional - DEFAULT=false - Should data be purged from apps the next time the device authenticates */
}

6.3.4. レスポンスボディー

6.3.4.1. 成功

{
  "status": "ok",
  "guid": "<global_unique_id>",
  "fields": {
    "cuid": "<id_assigned_by_device>",
    "name": "<Friendly_name_of_device>",
    "disabled": true|false, /* Is this device currently blocked from logging in */
    "blacklisted": true|false /* Should data be purged from apps the next time the device authenticates */
  }
}

6.3.4.2. エラー

{
  "status": "error",
  "message": "<error_message>"
}

6.4. アプリの一覧表示

6.4.1. 説明

指定されたデバイス ID から認証したアプリの一覧を返します。

6.4.2. エンドポイント

  • URI: /box/srv/1.1/admin/device/listapps
  • メソッド: POST

6.4.3. リクエストボディー

{
  "cuid": "<id_assigned_by_device>"
}

6.4.4. レスポンスボディー

6.4.4.1. 成功

{
  "status": "ok",
  "count": <total apps count>,
  "list" : [
    {
      "guid": <unique app guid>,
      "fields" : {
        "name" : <app name>,
        "description" : <app description>,
      }
    },
    ...
  ]
}

6.4.4.2. エラー

{
  "status": "error",
  "message": "<error_message>"
}

6.5. ユーザーの一覧表示

6.5.1. 説明

指定されたデバイス ID から認証したユーザー ID の一覧を返します。

6.5.2. エンドポイント

  • URI: /box/srv/1.1/admin/device/listusers
  • メソッド: POST

6.5.3. リクエストボディー

{
  "cuid": "<id_assigned_by_device>"
}

6.5.4. レスポンスボディー

6.5.4.1. 成功

{
  "status": "ok",
  "count": <total users count>,
  "list" : [
    {
      "guid": <unique user guid>,
      "fields" : {
        "userId" : <unique user id>,
        "email" : <user email>
      }
    },
    ...
  ]
}

6.5.4.2. エラー

{
  "status": "error",
  "message": "<error_message>"
}