### Install APK

Source: https://doc.some3c.com/panda-manual/api-interface-documentation

Installs an application (APK file) onto the mobile phone.

```APIDOC
## POST /api/apps/install

### Description
Installs an application (APK file) onto the mobile phone.

### Method
POST

### Endpoint
/api/apps/install

### Parameters
#### Request Body
- **action** (string) - Required - The action to perform, which is 'installApk'.
- **apkFile** (file) - Required - The APK file to install.
- **installType** (int) - Optional - Installation type. 0: normal install, 1: silent install. Defaults to 0.

### Request Example
```
(Form data with 'apkFile' and optional 'installType' fields)
```

### Response
#### Success Response (200)
- **code** (int) - Return code, typically 10000 for success.
- **message** (string) - Response message, typically "SUCCESS".
- **data** (null) - No data is returned on successful installation.

#### Response Example
```json
{
    "code": 10000,
    "message": "SUCCESS",
    "data": null
}
```
```

--------------------------------

### Get Application List

Source: https://doc.some3c.com/panda-manual/api-interface-documentation

Retrieves a list of all installed applications on the mobile phone.

```APIDOC
## POST /api/apps/list

### Description
Retrieves a list of all installed applications on the mobile phone.

### Method
POST

### Endpoint
/api/apps/list

### Parameters
#### Request Body
- **action** (string) - Required - The action to perform, which is 'apkList'.

### Request Example
```json
{
  "action": "apkList"
}
```

### Response
#### Success Response (200)
- **code** (int) - Return code, typically 10000 for success.
- **message** (string) - Response message, typically "SUCCESS".
- **data** (array) - An array of application objects, each containing details like package name and version.
  - **packageName** (string) - The package name of the application.
  - **versionName** (string) - The version name of the application.
  - **versionCode** (int) - The version code of the application.
  - **appName** (string) - The display name of the application.

#### Response Example
```json
{
    "code": 10000,
    "message": "SUCCESS",
    "data": [
        {
            "packageName": "com.android.settings",
            "versionName": "10",
            "versionCode": 10,
            "appName": "Settings"
        }
    ]
}
```
```

--------------------------------

### Install Screencast Input Method

Source: https://doc.some3c.com/panda-manual/api-interface-documentation

Silently installs the screencast input method. This is usually installed automatically when the mobile phone is connected, so it's not typically needed to call directly.

```APIDOC
## POST /api/ime/install_screencast

### Description
Silently installs the screencast input method. This is usually installed automatically when the mobile phone is connected, so it's not typically needed to call directly.

### Method
POST

### Endpoint
/api/ime/install_screencast

### Parameters
#### Request Body
- **action** (string) - Required - The action to perform, which is 'installInputIme'.

### Request Example
```json
{
  "action": "installInputIme"
}
```

### Response
#### Success Response (200)
- **code** (int) - Return code, typically 10000 for success.
- **message** (string) - Response message, typically "SUCCESS".
- **data** (null) - No data is returned on successful installation.

#### Response Example
```json
{
    "code": 10000,
    "message": "SUCCESS",
    "data": null
}
```
```

--------------------------------

### Create Task Request Example

Source: https://doc.some3c.com/panda-manual/api-interface-documentation

This JSON object demonstrates a request to create a new task. It includes parameters such as the action type, target devices, and task configuration including file path, execution count, start times, and intervals.

```JSON
{
    "action": "autojsCreate",
    "devices": "all",
    "data": [
        {
            "path": "D:\\code\\script\\666.js",
            "count": 2,
            "startTimes": ["2025-10-10 13:25:10"],
            "taskInterval": [1000, 5000],
            "deviceInterval": 1000
        }
    ]
}
```

--------------------------------

### Install APK API

Source: https://doc.some3c.com/panda-manual/api-interface-documentation

Installs an application by providing the local file path of the APK. May trigger security verification on some devices.

```APIDOC
## POST /websites/doc_some3c_panda-manual/installApk

### Description
Installs an application by providing the local file path of the APK. May trigger security verification on some devices.

### Method
POST

### Endpoint
/websites/doc_some3c_panda-manual/installApk

### Parameters
#### Request Body
- **action** (string) - Required - Request event, case insensitive. Example: "installApk"
- **devices** (string) - Required - Device serial number, 'all' or comma-separated list. Example: "all" or "xxx,xxx"
- **data** (json) - Required - JSON object containing installation details.
  - **filePath** (string) - Required - Local computer installation package file path. Example: "D:\\Downloads\\tqyyapkazb.apk"

### Request Example
```json
{
    "action":"installApk",
    "devices":"all",
    "data":{
        "filePath":"D:\\Downloads\\tqyyapkazb.apk"
    }
}
```

### Response
#### Success Response (200)
- **code** (int) - Return code. Example: 10000
- **message** (string) - Response message. Example: "SUCCESS"
- **data** (null) - Response data is null upon successful installation.

#### Response Example
```json
{
    "code": 10000,
    "message": "SUCCESS",
    "data": null
}
```

#### Error Response Examples
```json
{
    "code": 10001,
    "message": "Invalid action",
    "data": null
}
```
```json
{
    "code": 10001,
    "message": "Find local file error",
    "data": null
}
```
```

--------------------------------

### Get App List (apkList)

Source: https://doc.some3c.com/panda-manual/api-interface-documentation

Retrieves the package name and installation path of third-party apps installed on specified devices. Requires 'action' and 'devices' parameters. Returns a map of app details or an error code.

```json
{
    "action":"apkList",
    "devices":"all"
}
```

```json
{
    "code": 10000,
    "message": "SUCCESS",
    "data": {
        "ea85356a": [
            {
                "package": "/data/app/com.panda.assistant-1",
                "apk": "com.panda.assistant"
            },
            {
                "apk": "com.baidu.input_mi",
                "package": "/data/app/BaiduIME/BaiduIME"
            },
            {
                "package": "/data/app/talkback/talkback",
                "apk": "com.google.android.marvin.talkback"
            }
        ],
        "d609ef41": [
            {
                "package": "/data/app/OneKeyLockScreen/OneKeyLockScreen",
                "apk": "com.coloros.onekeylockscreen"
            },
            {
                "package": "/data/app/com.nearme.note-UKiAh14ZDIXnoci_NYkTcQ==",
                "apk": "com.nearme.note"
            },
            {
                "apk": "com.nearme.play",
                "package": "/data/app/com.nearme.play-9ci1OrRtCU7bK659l64Pyw=="
            }
        ]
    }
}
```

```json
{
    "code": 10001,
    "message": "Invalid action",
    "data": null
}
```

```json
{
    "code": 10001,
    "message": "Request parameter error",
    "data": null
}
```

--------------------------------

### Get Input Method List

Source: https://doc.some3c.com/panda-manual/api-interface-documentation

Retrieves a list of all input methods currently installed on the phone.

```APIDOC
## POST /api/ime/list

### Description
Retrieves a list of all input methods currently installed on the phone.

### Method
POST

### Endpoint
/api/ime/list

### Parameters
#### Request Body
- **action** (string) - Required - The action to perform, which is 'imeList'.

### Request Example
```json
{
  "action": "imeList"
}
```

### Response
#### Success Response (200)
- **code** (int) - Return code, typically 10000 for success.
- **message** (string) - Response message, typically "SUCCESS".
- **data** (array) - An array of input method objects.
  - **packageName** (string) - The package name of the input method.
  - **methodName** (string) - The display name of the input method.

#### Response Example
```json
{
    "code": 10000,
    "message": "SUCCESS",
    "data": [
        {
            "packageName": "com.google.android.inputmethod.latin",
            "methodName": "Gboard"
        }
    ]
}
```
```

--------------------------------

### Start APK

Source: https://doc.some3c.com/panda-manual/api-interface-documentation

Launches a specified application package on one or more devices.

```APIDOC
## POST /api/startApk

### Description
Launches a specified application package on one or more devices.

### Method
POST

### Endpoint
/api/startApk

### Parameters
#### Request Body
- **action** (string) - Required - Request event, case insensitive. Example: "startApk"
- **devices** (string) - Required - Device serial number, "all" means all, multiple device serial numbers are separated by commas. Example: "all" or "xxx,xxx"
- **data** (json) - Required - JSON object containing package information.
  - **apk** (string) - Required - The package name of the application to launch. Example: "com.coloros.weather"

### Request Example
```json
{
    "action":"startApk",
    "devices":"d609ef41",
    "data":{
        "apk":"com.coloros.weather"
    }
}
```

### Response
#### Success Response (200)
- **code** (int) - Return code, default 10000.
- **message** (string) - Response message, default "SUCCESS".
- **data** (null) - Always null for this operation.

#### Response Example
```json
{
    "code": 10000,
    "message": "SUCCESS",
    "data": null
}
```

#### Error Response Examples
```json
{
    "code": 10001,
    "message": "Invalid action",
    "data": null
}
```
```json
{
    "code": 10001,
    "message": "Request parameter error",
    "data": null
}
```
```

--------------------------------

### Start Application

Source: https://doc.some3c.com/panda-manual/api-interface-documentation

Launches a mobile application by its package name.

```APIDOC
## POST /api/apps/start

### Description
Launches a mobile application by its package name.

### Method
POST

### Endpoint
/api/apps/start

### Parameters
#### Request Body
- **action** (string) - Required - The action to perform, which is 'startApk'.
- **packageName** (string) - Required - The package name of the application to start.

### Request Example
```json
{
  "action": "startApk",
  "packageName": "com.example.app"
}
```

### Response
#### Success Response (200)
- **code** (int) - Return code, typically 10000 for success.
- **message** (string) - Response message, typically "SUCCESS".
- **data** (null) - No data is returned on successful launch.

#### Response Example
```json
{
    "code": 10000,
    "message": "SUCCESS",
    "data": null
}
```
```

--------------------------------

### Install APK (InstallApk)

Source: https://doc.some3c.com/panda-manual/api-interface-documentation

Installs an application on specified devices using a local APK file. Requires 'action', 'devices', and 'data' with 'filePath'. Some phone brands may prompt for security verification. Returns a success or error message.

```json
{
    "action":"installApk",
    "devices":"all",
    "data":{
        "filePath":"D:\\Downloads\\tqyyapkazb.apk"
    }
}
```

```json
{
    "code": 10000,
    "message": "SUCCESS",
    "data": null
}
```

```json
{
    "code": 10001,
    "message": "Invalid action",
    "data": null
}
```

```json
{
    "code": 10001,
    "message": "Find local file error",
    "data": null
}
```

--------------------------------

### App List API

Source: https://doc.some3c.com/panda-manual/api-interface-documentation

Retrieves the package name and installation path of third-party applications installed on the device.

```APIDOC
## POST /websites/doc_some3c_panda-manual/apkList

### Description
Retrieves the package name and installation path of third-party applications installed on the device.

### Method
POST

### Endpoint
/websites/doc_some3c_panda-manual/apkList

### Parameters
#### Request Body
- **action** (string) - Required - Request event, case insensitive. Example: "pullFile"
- **devices** (string) - Required - Device serial number, 'all' or comma-separated list. Example: "all" or "xxx,xxx"
- **data** (json) - Optional - Additional data for the request.

### Request Example
```json
{
    "action":"apkList",
    "devices":"all"
}
```

### Response
#### Success Response (200)
- **code** (int) - Return code. Example: 10000
- **message** (string) - Response message. Example: "SUCCESS"
- **data** (map) - JSON object containing app details or null. 
  - **apk** (string) - apk package name
  - **package** (string) - Installation path

#### Response Example
```json
{
    "code": 10000,
    "message": "SUCCESS",
    "data": {
        "ea85356a": [
            {
                "package": "/data/app/com.panda.assistant-1",
                "apk": "com.panda.assistant"
            },
            {
                "apk": "com.baidu.input_mi",
                "package": "/data/app/BaiduIME/BaiduIME"
            },
            {
                "package": "/data/app/talkback/talkback",
                "apk": "com.google.android.marvin.talkback"
            }
        ],
        "d609ef41": [
            {
                "package": "/data/app/OneKeyLockScreen/OneKeyLockScreen",
                "apk": "com.coloros.onekeylockscreen"
            },
            {
                "package": "/data/app/com.nearme.note-UKiAh14ZDIXnoci_NYkTcQ==",
                "apk": "com.nearme.note"
            },
            {
                "apk": "com.nearme.play",
                "package": "/data/app/com.nearme.play-9ci1OrRtCU7bK659l64Pyw=="
            }
        ]
    }
}
```

#### Error Response Examples
```json
{
    "code": 10001,
    "message": "Invalid action",
    "data": null
}
```
```json
{
    "code": 10001,
    "message": "Request parameter error",
    "data": null
}
```
```

--------------------------------

### Start Application via JSON Request

Source: https://doc.some3c.com/panda-manual/api-interface-documentation

This snippet shows how to launch an Android application using a JSON request. It specifies the action, target devices, and the package name of the application to start. The response includes a status code and message indicating the operation's outcome.

```json
{
    "action":"startApk",
    "devices":"d609ef41",
    "data":{
        "apk":"com.coloros.weather"
    }
}
```

--------------------------------

### API Request Example (JSON)

Source: https://doc.some3c.com/panda-manual/api-interface-documentation

This is an example of a JSON request payload for the Some3C API. It specifies the action to perform, the target devices, and any associated data.

```json
{
    "action":"pushEvent",
    "davices":"all",
    "data":{
        "type":"2"
    }
}
```

--------------------------------

### Install APK using ADB

Source: https://doc.some3c.com/panda-manual/adb-command-list

Installs an Android application package (APK) onto the device. Requires the absolute path to the APK file on the host machine.

```shell
adb install d:/temp/1.apk
```

--------------------------------

### Get All Tags

Source: https://doc.some3c.com/panda-manual/api-interface-documentation

Retrieves all current group labels associated with devices.

```APIDOC
## POST /api/tags/get

### Description
Retrieves all current group labels associated with devices.

### Method
POST

### Endpoint
/api/tags/get

### Parameters
#### Request Body
- **action** (string) - Required - The action to perform, which is 'getTags'.

### Request Example
```json
{
  "action": "getTags"
}
```

### Response
#### Success Response (200)
- **code** (int) - Return code, typically 10000 for success.
- **message** (string) - Response message, typically "SUCCESS".
- **data** (array) - An array of tag objects.
  - **id** (int) - The unique identifier for the tag.
  - **name** (string) - The name of the tag.

#### Response Example
```json
{
    "code": 10000,
    "message": "SUCCESS",
    "data": [
        {
            "id": 1,
            "name": "Production Devices"
        }
    ]
}
```
```

--------------------------------

### API Response Example (JSON)

Source: https://doc.some3c.com/panda-manual/api-interface-documentation

This is an example of a JSON response payload from the Some3C API, indicating the success or failure of a request and any returned data.

```json
{
    "code": 10000,
    "message": "SUCCESS",
    "data": null
}
```

--------------------------------

### Launch Application using ADB

Source: https://doc.some3c.com/panda-manual/adb-command-list

Starts a specific activity within an Android application. Requires the package name and the activity name to be launched.

```shell
adb shell am start -n cn.com.test.mobile/.ui.SplashActivity
```

--------------------------------

### Get Device List API

Source: https://doc.some3c.com/panda-manual/api-interface-documentation

Retrieves a list of all currently connected devices. It requires an 'action' parameter set to 'list'. The response includes details such as device model, name, connection mode, and screen dimensions.

```json
{
    "code": 10000,
    "message": "SUCCESS",
    "data": [
        {
            "width": 272,
            "height": 480,
            "serial": "ea85356a",
            "model": "Redmi Note 3",
            "sort": 1,
            "name": "Redmi Note 33",
            "onlySerial": "ea85356a",
            "hide": false,
            "mode": 0,
            "status": "online",
            "connectTime": 1714294839013,
            "intranetIp": "192.168.111.143",
            "sourceWidth": 1080,
            "sourceHeight": 1920
        }
    ]
}
```

```json
{
    "code": 10001,
    "message": "Request parameter error",
    "data": null
}
```

```json
{
    "code": 10001,
    "message": "Invalid action",
    "data": null
}
```

--------------------------------

### Get All Tags and Device Associations (JSON)

Source: https://doc.some3c.com/panda-manual/api-interface-documentation

This snippet shows how to retrieve all existing tags and the device serial numbers associated with each tag. The 'action' parameter must be set to 'getTags'. The 'devices' and 'data' parameters are optional.

```json
{
    "action":"getTags"
}
```

--------------------------------

### Error Return Examples

Source: https://doc.some3c.com/panda-manual/api-interface-documentation

These JSON objects demonstrate error responses from the API. They include an error code and a descriptive message indicating the nature of the error, such as an invalid action or incorrect request parameters.

```JSON
{
  "code": 10001,
  "message": "无效的action",
  "data": null
}
```

```JSON
{
  "code": 10001,
  "message": "请求参数错误",
  "data": null
}
```

--------------------------------

### Get Device List

Source: https://doc.some3c.com/panda-manual/api-interface-documentation

Retrieves a list of all currently connected devices. This API returns detailed information about each connected device, including its model, name, connection status, and dimensions.

```APIDOC
## GET /api/devices

### Description
Retrieves a list of all currently connected devices. This API returns detailed information about each connected device, including its model, name, connection status, and dimensions.

### Method
GET

### Endpoint
/api/devices

### Parameters
#### Query Parameters
- **action** (string) - Required - The action to perform, which is 'list' for this endpoint.

### Request Example
```json
{
  "action": "list"
}
```

### Response
#### Success Response (200)
- **code** (int) - Return code, default 10000.
- **message** (string) - Response message, default "SUCCESS".
- **data** (array) - Array of device objects. Contains device details if data is available, otherwise null.
  - **width** (int) - Width of the device screen.
  - **height** (int) - Height of the device screen.
  - **serial** (string) - The serial number of the current connection mode (e.g., IP for Wi-Fi).
  - **model** (string) - The model name of the mobile phone.
  - **sort** (int) - The device number or order.
  - **name** (string) - The custom name of the mobile phone.
  - **onlySerial** (string) - Unique serial number of the mobile phone, unaffected by connection mode.
  - **hide** (bool) - Indicates whether the screen status is turned off.
  - **mode** (int) - Connection mode: 0: USB; 1: WIFI, 2. OTG; 3. Accessibility.
  - **status** (string) - The online status of the device.
  - **connectTime** (int) - Connection timestamp.
  - **intranetIp** (string) - Intranet IP address of the device.
  - **sourceWidth** (int) - Original width of the device screen.
  - **sourceHeight** (int) - Original height of the device screen.

#### Response Example
```json
{
    "code": 10000,
    "message": "SUCCESS",
    "data": [
        {
            "width": 272,
            "height": 480,
            "serial": "ea85356a",
            "model": "Redmi Note 3",
            "sort": 1,
            "name": "Redmi Note 33",
            "onlySerial": "ea85356a",
            "hide": false,
            "mode": 0,
            "status": "online",
            "connectTime": 1714294839013,
            "intranetIp": "192.168.111.143",
            "sourceWidth": 1080,
            "sourceHeight": 1920
        }
    ]
}
```

#### Error Response Examples
```json
{
    "code": 10001,
    "message": "Request parameter error",
    "data": null
}
```
```json
{
    "code": 10001,
    "message": "Invalid action",
    "data": null
}
```
```

--------------------------------

### General Success Return Example

Source: https://doc.some3c.com/panda-manual/api-interface-documentation

This JSON object represents a successful API response. It includes a success code, a success message, and null data, indicating that the operation completed without issues and no specific data payload is required.

```JSON
{
  "code": 10000,
  "message": "SUCCESS",
  "data": null
}
```

--------------------------------

### Stop Task Request Example

Source: https://doc.some3c.com/panda-manual/api-interface-documentation

This JSON object illustrates a request to stop a currently executing task. It specifies the action to remove the task and identifies the target devices and the name of the task to be stopped.

```JSON
{
    "action": "autojsRemove",
    "devices": "all",
    "data": {
            "name": "贪吃蛇.js"
        }
}
```

--------------------------------

### Pull File Response - JSON

Source: https://doc.some3c.com/panda-manual/api-interface-documentation

These JSON examples show the responses for a file download request. A successful download returns a code of 10000 and a 'SUCCESS' message. Error responses, such as for invalid actions or incorrect parameters, are indicated by a code of 10001.

```json
{
    "code": 10000,
    "message": "SUCCESS",
    "data": null
}
```

```json
{
    "code": 10001,
    "message": "Invalid action",
    "data": null
}
```

```json
{
    "code": 10001,
    "message": "Request parameter error",
    "data": null
}
```

--------------------------------

### Upload File Response - JSON

Source: https://doc.some3c.com/panda-manual/api-interface-documentation

These JSON examples illustrate the possible responses from a file upload request. A successful upload returns a code of 10000 with a 'SUCCESS' message. Exception responses include codes like 10001 for invalid actions or file-related errors.

```json
{
    "code": 10000,
    "message": "SUCCESS",
    "data": null
}
```

```json
{
    "code": 10001,
    "message": "Invalid action",
    "data": null
}
```

```json
{
    "code": 10001,
    "message": "Find local file error",
    "data": null
}
```

--------------------------------

### Task Creation API

Source: https://doc.some3c.com/panda-manual/api-interface-documentation

Endpoint for creating and scheduling tasks. It allows specifying device details, script path, execution count, and timing intervals.

```APIDOC
## POST /websites/doc_some3c_panda-manual

### Description
Endpoint for creating and scheduling tasks. It allows specifying device details, script path, execution count, and timing intervals.

### Method
POST

### Endpoint
/websites/doc_some3c_panda-manual

### Parameters
#### Request Body
- **action** (string) - Required - Specifies the action to perform, e.g., "autojsCreate".
- **devices** (string) - Required - Device serial number(s) separated by commas, or "all" for all devices.
- **data** (Array) - Required - An array of task configurations.
  - **path** (string) - Required - The file path of the task script.
  - **count** (int) - Required - The number of times the task should be executed.
  - **startTimes** (Array) - Optional - An array of strings specifying the scheduled start times in 'YYYY-MM-DD HH:mm:ss' format.
  - **taskInterval** (Array) - Required - An array of two integers representing the random interval between task executions in milliseconds.
  - **deviceInterval** (string) - Required - The interval between device operations in milliseconds.

### Request Example
```json
{
    "action": "autojsCreate",
    "devices": "all",
    "data": [
        {
            "path": "D:\\code\\script\\666.js",
            "count": 2,
            "startTimes": ["2025-10-10 13:25:10"],
            "taskInterval": [1000, 5000],
            "deviceInterval": 1000
        }
    ]
}
```

### Response
#### Success Response (200)
- **code** (int) - The status code of the operation, e.g., 10000 for success.
- **message** (string) - A message indicating the result of the operation, e.g., "SUCCESS".
- **data** (null) - Returns JSON if data is available, otherwise returns null.

#### Response Example
```json
{
  "code": 10000,
  "message": "SUCCESS",
  "data": null
}
```

#### Error Response Examples
```json
{
  "code": 10001,
  "message": "无效的action",
  "data": null
}
```

```json
{
  "code": 10001,
  "message": "请求参数错误",
  "data": null
}
```
```

--------------------------------

### Create Tag

Source: https://doc.some3c.com/panda-manual/api-interface-documentation

Creates a new group label.

```APIDOC
## POST /api/tags/create

### Description
Creates a new group label.

### Method
POST

### Endpoint
/api/tags/create

### Parameters
#### Request Body
- **action** (string) - Required - The action to perform, which is 'addTag'.
- **name** (string) - Required - The name for the new tag.

### Request Example
```json
{
  "action": "addTag",
  "name": "Staging Servers"
}
```

### Response
#### Success Response (200)
- **code** (int) - Return code, typically 10000 for success.
- **message** (string) - Response message, typically
```

--------------------------------

### Quick Operation

Source: https://doc.some3c.com/panda-manual/api-interface-documentation

Performs quick operations corresponding to mobile phone buttons like task management, home, or back.

```APIDOC
## POST /api/quick/operation

### Description
Performs quick operations corresponding to mobile phone buttons. 1: Task management, 2: Home screen, 3: Return.

### Method
POST

### Endpoint
/api/quick/operation

### Parameters
#### Request Body
- **action** (string) - Required - The action to perform, which is 'pushEvent'.
- **type** (int) - Required - The type of quick operation (1, 2, or 3).

### Request Example
```json
{
  "action": "pushEvent",
  "type": 2  // Home screen
}
```

### Response
#### Success Response (200)
- **code** (int) - Return code, typically 10000 for success.
- **message** (string) - Response message, typically "SUCCESS".
- **data** (null) - No data is returned on successful operation.

#### Response Example
```json
{
    "code": 10000,
    "message": "SUCCESS",
    "data": null
}
```
```

--------------------------------

### Execute ADB Command

Source: https://doc.some3c.com/panda-manual/api-interface-documentation

Executes an ADB shell command on the connected device. Only the command after '[adb shell]' needs to be provided.

```APIDOC
## POST /api/adb/command

### Description
Executes an ADB shell command on the connected device. Only the command after '[adb shell]' needs to be provided.

### Method
POST

### Endpoint
/api/adb/command

### Parameters
#### Request Body
- **action** (string) - Required - The action to perform, which is 'adb'.
- **command** (string) - Required - The ADB command to execute (e.g., 'logcat -d').

### Request Example
```json
{
  "action": "adb",
  "command": "shell logcat -d"
}
```

### Response
#### Success Response (200)
- **code** (int) - Return code, typically 10000 for success.
- **message** (string) - Response message, typically "SUCCESS".
- **data** (string) - The output of the executed ADB command.

#### Response Example
```json
{
    "code": 10000,
    "message": "SUCCESS",
    "data": "Logcat output here..."
}
```
```

--------------------------------

### Uninstall APK

Source: https://doc.some3c.com/panda-manual/api-interface-documentation

Uninstalls an application from the mobile phone.

```APIDOC
## POST /api/apps/uninstall

### Description
Uninstalls an application from the mobile phone.

### Method
POST

### Endpoint
/api/apps/uninstall

### Parameters
#### Request Body
- **action** (string) - Required - The action to perform, which is 'uninstallApk'.
- **packageName** (string) - Required - The package name of the application to uninstall.

### Request Example
```json
{
  "action": "uninstallApk",
  "packageName": "com.example.app"
}
```

### Response
#### Success Response (200)
- **code** (int) - Return code, typically 10000 for success.
- **message** (string) - Response message, typically "SUCCESS".
- **data** (null) - No data is returned on successful uninstallation.

#### Response Example
```json
{
    "code": 10000,
    "message": "SUCCESS",
    "data": null
}
```
```

--------------------------------

### Select Input Method

Source: https://doc.some3c.com/panda-manual/api-interface-documentation

Selects the current input method on the mobile phone.

```APIDOC
## POST /api/ime/select

### Description
Selects the current input method on the mobile phone.

### Method
POST

### Endpoint
/api/ime/select

### Parameters
#### Request Body
- **action** (string) - Required - The action to perform, which is 'selectIme'.
- **packageName** (string) - Required - The package name of the input method to select.

### Request Example
```json
{
  "action": "selectIme",
  "packageName": "com.google.android.inputmethod.latin"
}
```

### Response
#### Success Response (200)
- **code** (int) - Return code, typically 10000 for success.
- **message** (string) - Response message, typically "SUCCESS".
- **data** (null) - No data is returned on successful selection.

#### Response Example
```json
{
    "code": 10000,
    "message": "SUCCESS",
    "data": null
}
```
```

--------------------------------

### Download File API

Source: https://doc.some3c.com/panda-manual/api-interface-documentation

Enables downloading files from a device to a specified path on the local computer. Supports defining source file path and destination save path.

```APIDOC
## POST /pullFile

### Description
Downloads a file from a device to your local computer. You can specify the source file path on the device and the destination path on your computer.

### Method
POST

### Endpoint
/pullFile

### Parameters
#### Request Body
- **action** (string) - Required - The action to perform, e.g., "pullFile".
- **devices** (string) - Required - Specifies the target device(s). Use "all" for all devices or a comma-separated list of device serial numbers.
- **data** (json) - Required - A JSON object containing file transfer details.
  - **filePath** (string) - Required - The resource file path on the mobile phone.
  - **savePath** (string) - Optional - The computer path to save the file. If not provided, defaults to "D:\\Downloads\\serial number _ file name". The directory must exist.

### Request Example
```json
{
    "action": "pullFile",
    "devices": "all",
    "data": {
        "filePath": "/sdcard/Download/ad-link.txt",
        "savePath": "D:\\Downloads\\ad-link.txt"
    }
}
```

### Response
#### Success Response (200)
- **code** (int) - The return code, e.g., 10000 for success.
- **message** (string) - The response message, e.g., "SUCCESS".
- **data** (null) - Placeholder for potential data, usually null for this operation.

#### Error Response Examples
- **code**: 10001, **message**: "Invalid action", **data**: null
- **code**: 10001, **message**: "Request parameter error", **data**: null
```

--------------------------------

### Send Input Text to Devices (JSON)

Source: https://doc.some3c.com/panda-manual/api-interface-documentation

This snippet demonstrates how to send text input to specified devices. It requires the 'action', 'devices', and 'data' parameters. The 'data' object must contain the 'content' to be entered.

```json
{
    "action":"inputText",
    "devices":"ea85356a",
    "data":{
        "content":"熊猫投屏"
    }
}
```

--------------------------------

### File Upload

Source: https://doc.some3c.com/panda-manual/api-interface-documentation

Uploads a file from the computer to the mobile phone.

```APIDOC
## POST /api/file/upload

### Description
Uploads a file from the computer to the mobile phone.

### Method
POST

### Endpoint
/api/file/upload

### Parameters
#### Request Body
- **action** (string) - Required - The action to perform, which is 'uploadFile'.
- **file** (file) - Required - The file to upload.
- **path** (string) - Required - The destination path on the mobile phone.

### Request Example
```
(Form data with 'file' and 'path' fields)
```

### Response
#### Success Response (200)
- **code** (int) - Return code, typically 10000 for success.
- **message** (string) - Response message, typically "SUCCESS".
- **data** (null) - No data is returned on successful operation.

#### Response Example
```json
{
    "code": 10000,
    "message": "SUCCESS",
    "data": null
}
```
```

--------------------------------

### addTag

Source: https://doc.some3c.com/panda-manual/api-interface-documentation

Creates a new tag group for organizing devices. Allows specifying a name for the new tag.

```APIDOC
## POST /api/devices/addTag

### Description
Creates a new tag group for organizing devices. Allows specifying a name for the new tag.

### Method
POST

### Endpoint
/api/devices/addTag

### Parameters
#### Request Body
- **action** (string) - Required - Request event, case insensitive. Example: "addTag"
- **devices** (string) - Optional - Device serial number, 'all' means all, multiple device serial numbers are separated by commas. Example: "all" or "xxx,xxx"
- **data** (json) - Required - JSON object containing tag details.
  - **name** (string) - Required - The name for the new tag. Example: "测试一组"

### Request Example
```json
{
    "action":"addTag",
    "data":{
        "name":"测试一组"
    }
}
```

### Response
#### Success Response (200)
- **code** (int) - Return code. Example: 10000
- **message** (string) - Response message. Example: "SUCCESS"
- **data** (json) - Response data, null if no data. Example: null

#### Response Example
```json
{
    "code": 10000,
    "message": "SUCCESS",
    "data": null
}
```

#### Error Responses
- **code** (int) - Error code. Example: 10001
- **message** (string) - Error message. Example: "Invalid action" or "Request parameter error"
- **data** (json) - Error data, null. Example: null

#### Exception Return Example 1
```json
{
    "code": 10001,
    "message": "Invalid action",
    "data": null
}
```

#### Exception Return Example 2
```json
{
    "code": 10001,
    "message": "Request parameter error",
    "data": null
}
```
```

--------------------------------

### Upload File API

Source: https://doc.some3c.com/panda-manual/api-interface-documentation

Handles the upload of files from a local computer to a specified directory on a device. Supports different actions and device targeting.

```APIDOC
## POST /uploadFile

### Description
Uploads a file from your local computer to a specified directory on a device. You can choose to upload to the default download directory or the camera album directory.

### Method
POST

### Endpoint
/uploadFile

### Parameters
#### Request Body
- **action** (string) - Required - The action to perform, e.g., "writeClipBoard".
- **devices** (string) - Required - Specifies the target device(s). Use "all" for all devices or a comma-separated list of device serial numbers.
- **data** (json) - Required - A JSON object containing file transfer details.
  - **filePath** (string) - Required - The local computer path to the file to be uploaded.
  - **isMedia** (string) - Optional - Determines the upload directory. "0" for default download directory, "1" for camera album directory. Defaults to "0".

### Request Example
```json
{
    "action": "uploadFile",
    "devices": "all",
    "data": {
        "filePath": "C:\\Users\\Administrator\\Desktop\\upload.a.txt",
        "isMedia": "0"
    }
}
```

### Response
#### Success Response (200)
- **code** (int) - The return code, e.g., 10000 for success.
- **message** (string) - The response message, e.g., "SUCCESS".
- **data** (null) - Placeholder for potential data, usually null for this operation.

#### Error Response Examples
- **code**: 10001, **message**: "Invalid action", **data**: null
- **code**: 10001, **message**: "Find local file error", **data**: null
```

--------------------------------

### Create a New Tag Group (JSON)

Source: https://doc.some3c.com/panda-manual/api-interface-documentation

This snippet illustrates how to create a new tag group for organizing devices. It requires the 'action' parameter set to 'addTag' and a 'data' object containing the 'name' of the new tag. The 'devices' parameter is optional.

```json
{
    "action":"addTag",
    "data":{
        "name":"测试一组"
    }
}
```

--------------------------------

### Download File to Computer

Source: https://doc.some3c.com/panda-manual/api-interface-documentation

Downloads a file from the mobile phone to the computer. By default, it is saved in the 'D:\\Downloads' directory.

```APIDOC
## POST /api/file/download

### Description
Downloads a file from the mobile phone to the computer. By default, it is saved in the 'D:\\Downloads' directory.

### Method
POST

### Endpoint
/api/file/download

### Parameters
#### Request Body
- **action** (string) - Required - The action to perform, which is 'pullFile'.
- **phonePath** (string) - Required - The path of the file on the mobile phone.
- **computerPath** (string) - Optional - The destination path on the computer. Defaults to 'D:\\Downloads'.

### Request Example
```json
{
  "action": "pullFile",
  "phonePath": "/sdcard/Download/myfile.txt",
  "computerPath": "D:\\MyCustomDownloads"
}
```

### Response
#### Success Response (200)
- **code** (int) - Return code, typically 10000 for success.
- **message** (string) - Response message, typically "SUCCESS".
- **data** (string) - The file path where the file is saved on the computer.

#### Response Example
```json
{
    "code": 10000,
    "message": "SUCCESS",
    "data": "D:\\Downloads\\myfile.txt"
}
```
```

--------------------------------

### Take Screenshot

Source: https://doc.some3c.com/panda-manual/api-interface-documentation

Captures a screenshot of the current mobile phone frame and saves it to the computer.

```APIDOC
## POST /api/screenshot

### Description
Captures a screenshot of the current mobile phone frame and saves it to the computer. By default, it is saved in the 'D:\\Pictures' directory.

### Method
POST

### Endpoint
/api/screenshot

### Parameters
#### Request Body
- **action** (string) - Required - The action to perform, which is 'screen'.

### Request Example
```json
{
  "action": "screen"
}
```

### Response
#### Success Response (200)
- **code** (int) - Return code, typically 10000 for success.
- **message** (string) - Response message, typically "SUCCESS".
- **data** (string) - The file path where the screenshot is saved on the computer.

#### Response Example
```json
{
    "code": 10000,
    "message": "SUCCESS",
    "data": "D:\\Pictures\\screenshot_12345.png"
}
```
```

--------------------------------

### Uninstall APK

Source: https://doc.some3c.com/panda-manual/api-interface-documentation

Uninstalls a specified APK package from one or more devices.

```APIDOC
## POST /api/uninstallApk

### Description
Uninstalls a specified APK package from one or more devices.

### Method
POST

### Endpoint
/api/uninstallApk

### Parameters
#### Request Body
- **action** (string) - Required - Request event, case insensitive. Example: "uninstallApk"
- **devices** (string) - Required - Device serial number, "all" means all, multiple device serial numbers are separated by commas. Example: "all" or "xxx,xxx"
- **data** (json) - Required - JSON object containing package information.
  - **apk** (string) - Required - The package name of the APK to uninstall. Example: "cn.androidfun.apkfetch"

### Request Example
```json
{
    "action":"uninstallApk",
    "devices":"d609ef41",
    "data":{
        "apk":"cn.androidfun.apkfetch"
    }
}
```

### Response
#### Success Response (200)
- **code** (int) - Return code, default 10000.
- **message** (string) - Response message, default "SUCCESS".
- **data** (null) - Always null for this operation.

#### Response Example
```json
{
    "code": 10000,
    "message": "SUCCESS",
    "data": null
}
```

#### Error Response Examples
```json
{
    "code": 10001,
    "message": "Invalid action",
    "data": null
}
```
```json
{
    "code": 10001,
    "message": "Request parameter error",
    "data": null
}
```
```