DuoPlus

https://help.duoplus.net/docs/
Admin
DuoPlus is a cloud phone service that provides virtual Android devices with features like proxy...
Tokens:78,920
Snippets:749
Trust Score:7.8
Update:4 months ago
Show doc for...
Tokens:
Raw
### Install and Start OpenClaw

Source: https://help.duoplus.net/docs/OpenClaw-Deployment-and-Cloud-Phone

Installs OpenClaw globally using npm and starts the gateway service. Access the web interface via http://localhost:3000.

```bash
# Install OpenClaw
npm install -g openclaw

# Start the service
openclaw gateway start

# Access the web interface
# Open in browser: http://localhost:3000
```

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

### Batch Install App Request Example

Source: https://help.duoplus.net/docs/Batch-Install-App

Use this JSON payload to initiate a batch installation of an application on specified cloud phones. Ensure 'image_ids' contains valid cloud phone identifiers and 'app_id' is the correct application ID.

```json
{
    "image_ids": [
        "xx"
    ],
    "app_id": "9Jp7o#0",
    "app_version_id": "9Jp7o#0"
}
```

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

### Start Application on Cloud Device

Source: https://help.duoplus.net/docs/adb-command-intro

Starts an application on the cloud device using its package name. This command dynamically finds the main activity to start.

```sh
am start -n $(dumpsys package [package_name] | grep -A 1 'MAIN' | grep '[package_name]' | sed -n 's/.*\(package_name\/[^ ]*\).*/\1/p')
```

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

### Install and Manage Module via ADB and D+

Source: https://help.duoplus.net/docs/How-to-develop-plugin-modules

Connect to the cloud machine, install the module APK, view installed modules, and uninstall modules using D+ commands.

```bash
// First connect to the cloud machine
adb connect xx.xx.xx.xx

// Enter the cloud machine terminal
adb shell

// Then install the module
dplus install patch:/sdcard/Download/app-debug.apk

// After successful installation, view the module
dplus dump

// Uninstall and delete the module by module name
dplus uninstall dplus_demo
```

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

### Install Application on Cloud Device

Source: https://help.duoplus.net/docs/adb-command-intro

Installs an application package from the specified path on the cloud device.

```sh
pm install /sdcard/test.apk
```

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

### Install Dependencies and Skills with OpenClaw

Source: https://help.duoplus.net/docs/OpenClaw-Deployment-and-Cloud-Phone

Instructs OpenClaw via chat to install ADB, ClawHub, and the duoplus-agent skill. OpenClaw handles OS detection, installation, and verification.

```text
Help me install adb, clawhub, and the duoplus-agent skill.
```

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

### List All Installed Packages

Source: https://help.duoplus.net/docs/app-accessibility-services

If the package name is unknown, this command lists all third-party packages installed on the cloud phone.

```shell
pm list packages -3
```

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

### Live Streaming Request Example

Source: https://help.duoplus.net/docs/Live-Streaming

Example JSON payload for initiating a live stream. Ensure the video file is in MP4 format and pushed to the /sdcard/DCIM/Camera directory.

```json
{
    "image_id": "xxxx",
    "id": "xxxx",
    "status": 1,
    "loop": 2
}
```

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

### Batch Set Root Request Example

Source: https://help.duoplus.net/docs/Batch-Set-Root

Example of a POST request to the /api/v1/cloudPhone/batchRoot endpoint to enable root access for specified packages on cloud devices.

```json
{
    "image_ids": ["xx"],
    "status": 3,
    "packages":["xxx","xxx2"]
}
```

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

### Get List of Installed Package Names

Source: https://help.duoplus.net/docs/adb-command-intro

Retrieves a list of all installed third-party package names on the device.

```sh
pm list packages -3 | cut -d ":" -f 2
```

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

### Module Configuration Example

Source: https://help.duoplus.net/docs/How-to-develop-plugin-modules

Defines module properties such as name, package, type, injected SO files, and target package names for injection.

```json
{
    "name": "dplus_demo",   // Module name, used during uninstallation
    "package":"com.example.dplus_demo",  // Module package name
    "desc": "module",       // Module description
    "type": "user",         // Module type, mainly "system" or "user"
    "libs": "libdplus_demo.so",  // SO files to inject; can be omitted or configured with multiple entries separated by ';'
    "pattern": [
        "com.android.settings"   // Package names where the module takes effect
    ]
}
```

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

### Batch Add Proxies Request Example

Source: https://help.duoplus.net/docs/Batch-Add-Proxies

Example JSON payload for adding a proxy. The proxy_list array supports up to 20 entries.

```json
{
    "proxy_list": [
        {
            "protocol": "socks5",
            "host": "host",
            "port": "3000",
            "user": "user",
            "password": "pass",
            "name": "name"
        }
    ],
    "ip_scan_channel": "ip2location"
}
```

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

### POST /api/v1/app/start

Source: https://help.duoplus.net/docs/Batch-Start-App

Starts multiple cloud phones with a specified application package. Supports up to 20 cloud phone IDs per request.

```APIDOC
## POST /api/v1/app/start

### Description
Starts multiple cloud phones with a specified application package. Supports up to 20 cloud phone IDs per request.

### Method
POST

### Endpoint
/api/v1/app/start

### Parameters
#### Request Body
- **image_ids** (array) - Required - Cloud Phone IDs, up to 20 items
- **pkg** (string) - Required - The package name of the application to start.

### Request Example
```json
{
    "image_ids": [
        "xx"
    ],
    "pkg": "com.zhiliaoapp.musically"
}
```

### Response
#### Success Response (200)
- **code** (integer) - The status code of the operation.
- **data** (object) - Contains additional data about the response.
  - **message** (string) - A message indicating the success of the operation.
- **message** (string) - A general message indicating the success of the operation.

#### Response Example
```json
{
    "code": 200,
    "data": {
        "message": "Success"
    },
    "message": "Success"
}
```
```

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

### Response Body for Installed App List

Source: https://help.duoplus.net/docs/List-of-Installed-App

The API returns this structure indicating the status and the list of installed applications.

```json
{
    "code": 200,
    "data": {
        "list": [
            "com.zhiliaoapp.musically",
            "com.twitter.android"
        ]
    },
    "message": "Success"
}
```

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

### Batch Set Root Response Example

Source: https://help.duoplus.net/docs/Batch-Set-Root

Example response from the Batch Set Root API, indicating success and failure status for cloud phone IDs and providing reasons for failures.

```json
{
    "code": 200,
    "data": {
        "success": [
            "FnR9i"
        ],
        "fail": [],
        "fail_reason": [
 "xx": "error message"
]
    },
    "message": "Success"
}
```

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

### Batch Add Proxies Response Example

Source: https://help.duoplus.net/docs/Batch-Add-Proxies

Example JSON response indicating the success or failure of individual proxy additions based on their index in the submitted array.

```json
{
    "code": 200,
    "data": {
        "success": [
            {
                "index": 0, // Submitted array index
                "id": "xx" // ID
            }
        ],
        "fail": [
            {
                "index": 1, // Submitted array index
                "message": "xx" // Error message
            }
        ]
    },
    "message": "Success"
}
```

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

### Platform App List Request Example

Source: https://help.duoplus.net/docs/List-of-Platform-App

Send a POST request to /api/v1/app/list with optional page and pagesize parameters to retrieve a list of applications.

```json
{
    "page": 1,
    "pagesize": 100
}
```

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

### Batch Enable ADB Request Example

Source: https://help.duoplus.net/docs/Batch-Enable-ADB

This JSON payload demonstrates how to structure a request to enable ADB for a list of cloud phone IDs.

```json
{
    "image_ids": ["xx"],
}
```

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

### Batch Create Groups Response Example

Source: https://help.duoplus.net/docs/Batch-Create-Groups

This is an example of the API response after attempting to batch create groups. It indicates which groups were successfully created and which failed, along with error details for failures.

```json
{
    "code": 200,
    "data": {
        "success": [
            {
                "index": 0, 
                "id": "xx", 
                "name": "xx",
                "sort": 100,
                "remark": "xx"
            }
        ],
        "fail": [
            {
                "index": 1, 
                "code": 408, 
                "message": "xx"
            }
        ]
    },
    "message": "Success"
}
```

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

### POST /api/v1/app/install

Source: https://help.duoplus.net/docs/Batch-Install-App

Installs a specified application on multiple cloud phones in a batch. This endpoint is designed for efficient deployment of applications across a fleet of devices.

```APIDOC
## POST /api/v1/app/install

### Description
Installs a specified application on multiple cloud phones in a batch. This endpoint is designed for efficient deployment of applications across a fleet of devices.

### Method
POST

### Endpoint
/api/v1/app/install

### Parameters
#### Request Body
- **image_ids** (array) - Required - Cloud Phone IDs, up to 20 items
- **app_id** (string) - Required - app_id
- **app_version_id** (string) - Optional - app_version_id, If empty, the first-ranked version will be used.

### Request Example
{
    "image_ids": [
        "xx"
    ],
    "app_id": "9Jp7o#0",
    "app_version_id": "9Jp7o#0"
}

### Response
#### Success Response (200)
- **code** (integer) - HTTP status code
- **data** (object) - Contains the result of the operation
  - **message** (string) - Success message
- **message** (string) - General success message

#### Response Example
{
    "code": 200,
    "data": {
        "message": "Success"
    },
    "message": "Success"
}
```

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

### Cloud Phone Resource List Response Example

Source: https://help.duoplus.net/docs/os-region-list

Example JSON response when retrieving a list of cloud phone resources. This shows the structure of the returned data, including region, OS ID, operating system, and counts.

```json
{
    "code": 200,
    "data": {
        "list": [
            {
                "name": "xx",  // Region
                "region_id": "mgRg1",  // OS ID
                "os": "Android 15", // Operating system
                "count": 0, // Cloud phone count
                "used_count": 0  // Connected cloud phone count
            }
        ]
    },
    "message": "Success"
}
```

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

### Example Request Parameters

Source: https://help.duoplus.net/docs/Introduction

This snippet shows the format for transmitting request parameters as a JSON string.

```json
{
"key":"value"
}
```

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

### POST /api/v1/app/teamList

Source: https://help.duoplus.net/docs/List-of-Team-App

Retrieve the list of installable team applications, supporting pagination with up to 100 items per page.

```APIDOC
## POST /api/v1/app/teamList

### Description
Retrieve the list of installable team applications, supporting pagination with up to 100 items per page.

### Method
POST

### Endpoint
/api/v1/app/teamList

### Parameters
#### Query Parameters
- **page** (int) - Optional - Request the page number. If not provided, it defaults to the first page.
- **pagesize** (int) - Optional - Number of items per page. If not provided, it defaults to 10 items per page.

### Request Example
```json
{
    "page": 1,
    "pagesize": 100
}
```

### Response
#### Success Response (200)
- **code** (int) - HTTP status code.
- **data** (object) - Contains the list of applications and pagination details.
  - **list** (array) - Array of application objects.
    - **id** (string) - app_id of the application.
    - **name** (string) - Name of the application.
    - **pkg** (string) - Package name of the application.
    - **version_list** (array) - List of available versions for the application.
      - **id** (string) - app_version_id of the version.
      - **name** (string) - Name of the version.
  - **page** (int) - Current page number.
  - **pagesize** (int) - Number of items per page.
  - **total** (int) - Total number of applications available.
  - **total_page** (int) - Total number of pages.
- **message** (string) - Success message.

#### Response Example
```json
{
    "code": 200,
    "data": {
        "list": [
            {
                "id": "9Jp7o#1",
                "name": "TikTok",
                "pkg": "com.zhiliaoapp.musically",
                "version_list": [
                    {
                        "id": "9Jp7o#1",
                        "name": "33.0.3"
                    }
                ]
            }
        ],
        "page": 1,
        "pagesize": 10,
        "total": 1,
        "total_page": 1
    },
    "message": "Success"
}
```
```

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

### Subscription Startup Purchase Request Example

Source: https://help.duoplus.net/docs/Subscription-Startup

This JSON object demonstrates the structure of a POST request to purchase a subscription startup. It includes parameters like duration, quantity, and optional coupon code and renewal status.

```json
{
    "duration": "90",
    "quantity": 1,
    "coupon_code": "xxxx",
    "renewal_status": 1
}
```

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

### Get Installed Apps List

Source: https://help.duoplus.net/docs/List-of-Installed-App

Retrieves a list of applications installed on a cloud phone. Requires the cloud phone's image ID.

```APIDOC
## POST /api/v1/app/installedList

### Description
Get the list of installed applications on a cloud phone.

### Method
POST

### Endpoint
/api/v1/app/installedList

### Parameters
#### Query Parameters
- **image_id** (string) - Yes - Cloud phone ID

### Request Example
```json
{
    "image_id": "xx"
}
```

### Response
#### Success Response (200)
- **code** (integer) - HTTP status code
- **data** (object) - Contains the list of installed applications
  - **list** (array) - Array of strings, where each string is an application identifier
- **message** (string) - Success message

#### Response Example
```json
{
    "code": 200,
    "data": {
        "list": [
            "com.zhiliaoapp.musically",
            "com.twitter.android"
        ]
    },
    "message": "Success"
}
```
```

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

### Subscription Startup List Request Example

Source: https://help.duoplus.net/docs/Subscription-Startup-List

This JSON object demonstrates a sample request to the subscription startup list endpoint. It includes parameters for pagination, sorting, and filtering by ID, name, renewal status, and availability.

```json
{
    "page": 1,
    "pagesize": 10,
    "sort_by": "created_at",
    "order": "desc",
    "id": "xxx",
    "name": "xxx",
    "renewal_status": 0,
    "free_status": 0,
    "remark": "xxx"
}
```

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

### Timezone List API Request Example

Source: https://help.duoplus.net/docs/timezone-list

Example of a POST request payload to the timezoneList API endpoint. Specify the ISO 3166-1 alpha-2 country code to get the relevant timezone list.

```json
{
    "iso": "GB"
}
```

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

### Subscription Startup List Response Example

Source: https://help.duoplus.net/docs/Subscription-Startup-List

This JSON object shows a successful response from the subscription startup list endpoint. It contains the list of subscription startups, pagination details, and a success message.

```json
{
    "code": 200,
    "data": {
        "list": [
            {
                "id": "xx", // ID
                "name": "xx",  // Name
                "cpu": "xx", // CPUs
                "ram": "4G",  // RAM
                "rom": "32G", // ROM
                "renewal_status": 0, // Auto-Renewal
                "free_status": 0, // Is available: 0 No; 1 Yes 
                "remark": "xx", // Remark
                "expired_at": "1770108845", // Expiry time
                "created_at": "1759136045",  // Create time
                "need_renewal": false  // Is about to expire
            }
        ],
        "page": 1,
        "pagesize": 10,
        "total": 1,
        "total_page": 1
    },
    "message": "Success"
}
```

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

### Upload File using Windows CMD

Source: https://help.duoplus.net/docs/Upload-Local-Files-to-Cloud-Drive

This Windows CMD example demonstrates uploading a local file using a pre-signed URL. Ensure that all variables like %x-oss-callback% and %signedUrl% are correctly set.

```cmd
curl.exe ^
  -X PUT ^
  -H "x-oss-callback: %x-oss-callback%" ^
  -H "x-oss-callback-var: %x-oss-callback-var%" ^
  -T "D:\Downloads\test.apk" ^
  "%signedUrl%"
```

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

### Initialize Proxy Request Example

Source: https://help.duoplus.net/docs/proxy-init

This snippet demonstrates a complete request to initialize a proxy for cloud phone services. It includes detailed configurations for images, proxy settings, location, SIM, and locale.

```json
{
    "images": [
        {
            "image_id": "xxx",
            "name": "xxx",
            "ip_scan_channel": "ip2location",
            "proxy": {
                "protocol": "socks5",
                "host": "xx.xx.xx.xx",
                "port": "xxxx",
                "user": "xxx",
                "password": "xxx"
            },
            "dpi_name": "720x1600(320dpi)",
            "network_mode": 2,
            "brand": "samsung",
            "model": "SM-A025F",
            "location": {
                "longitude": "xxx",
                "latitude": "xxx"
            },
            "sim": {
                "type": 2,
                "country": "GB"
            },
            "locale": {
                "country": "GB",
                "timezone": "Europe/London",
                "language": "en-GB"
            }
        },
        {
            "image_id": "xxx",
            "ip_scan_channel": "ip2location",
            "proxy": {
                "id": "xxx"
            }
        }
    ]
}
```

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

### Cloud Number List Request Example

Source: https://help.duoplus.net/docs/cloud-number-list

Example of a POST request to the Cloud Number List API with various filtering and sorting parameters.

```json
{
    "page": 1,
    "pagesize": 10,
    "sort_by": "created_at",
    "order": "asc",
    "phone_number": "xxxxxxxxx",
    "region_ids": ["US","GB"],
    "type_ids": [1,2],
    "status": [2],
    "renewal_status": [1,0],
    "remark": "xxx"
}
```

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

### Cloud Number List Response Example

Source: https://help.duoplus.net/docs/cloud-number-list

Example of a successful response from the Cloud Number List API, showing a list of cloud numbers with their details.

```json
{
    "code": 200,
    "data": {
        "list": [
            {
                "id": "6XdPL", // Cloud Number Id
                "phone_number": "", // Phone Number, if empty, indicates that it is being generated.
                "region_name": "US", // Region Name
                "type_name": "VOIP", // Type Name
                "renewal_status": 0, // Auto Renewal, 0: No, 1: Yes
                "remark": "", // Remark
                "status_name": "Normal", // Status Name
                "expired_at": "2026-01-30 18:10:49" // Expiry Time
                "created_at": "2025-12-08 11:05:15"  // Create Time
            }
        ],
        "page": 1,
        "pagesize": 10,
        "total": 1,
        "total_page": 1
    },
    "message": "Success"
}
```

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

### Request Example for Upload

Source: https://help.duoplus.net/docs/Upload-Local-Files-to-Cloud-Drive

This JSON object shows the expected parameters when requesting an upload URL, including the file name, whether it's an app, and its package name if applicable.

```json
{
   "name":"test.apk",
   "is_app": 1,
   "pkg": "com.test.apk"
}
```

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

### Timezone List API Response Example

Source: https://help.duoplus.net/docs/timezone-list

Example of a successful response from the timezoneList API. The 'data' field contains an array of timezone objects, each with an 'id' and 'name'.

```json
{
    "code": 200,
    "data": [
        {
            "id": "Europe/London",   // Timezone
            "name": "Europe/London(GMT+01:00)"   // Name
        }
    ],
    "message": "Success"
}
```

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

### POST /api/v1/subscriptionStartup/list

Source: https://help.duoplus.net/docs/Subscription-Startup-List

Retrieves a list of subscription startups. Supports pagination and filtering by various parameters.

```APIDOC
## POST /api/v1/subscriptionStartup/list

### Description
Retrieve the list of subscription startup, supports pagination, with a maximum of 100 records per page.

### Method
POST

### Endpoint
/api/v1/subscriptionStartup/list

### Parameters
#### Query Parameters
- **id** (string) - No - ID
- **name** (string) - No - Name
- **remark** (string) - No - Remark
- **renewal_status** (int) - No - Auto-Renewal: 0 No; 1 Yes
- **free_status** (int) - Yes - Availability: 0 No; 1 Yes
- **sort_by** (string) - No - Sorting field. Options: name (Name); created_at (Create Time); expired_at (Expiry Time)
- **order** (string) - No - Sorting order. Use **sort_by** to specify the sort field. Use asc for ascending order or desc for descending.
- **page** (int) - No - Request page number, defaults to the first page if not provided
- **pagesize** (int) - No - Number of items per page, defaults to 10 items/page if not provided

### Request Example
```json
{
    "page": 1,
    "pagesize": 10,
    "sort_by": "created_at",
    "order": "desc",
    "id": "xxx",
    "name": "xxx",
    "renewal_status": 0,
    "free_status": 0,
    "remark": "xxx"
}
```

### Response
#### Success Response (200)
- **code** (int) - Response code
- **data** (object) - Response data
  - **list** (array) - List of subscription startups
    - **id** (string) - ID
    - **name** (string) - Name
    - **cpu** (string) - CPUs
    - **ram** (string) - RAM
    - **rom** (string) - ROM
    - **renewal_status** (int) - Auto-Renewal
    - **free_status** (int) - Is available: 0 No; 1 Yes
    - **remark** (string) - Remark
    - **expired_at** (string) - Expiry time
    - **created_at** (string) - Create time
    - **need_renewal** (boolean) - Is about to expire
  - **page** (int) - Current page number
  - **pagesize** (int) - Number of items per page
  - **total** (int) - Total number of items
  - **total_page** (int) - Total number of pages
- **message** (string) - Response message

#### Response Example
```json
{
    "code": 200,
    "data": {
        "list": [
            {
                "id": "xx",
                "name": "xx",
                "cpu": "xx",
                "ram": "4G",
                "rom": "32G",
                "renewal_status": 0,
                "free_status": 0,
                "remark": "xx",
                "expired_at": "1770108845",
                "created_at": "1759136045",
                "need_renewal": false
            }
        ],
        "page": 1,
        "pagesize": 10,
        "total": 1,
        "total_page": 1
    },
    "message": "Success"
}
```
```

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

### Proxy List Response Example

Source: https://help.duoplus.net/docs/proxy-list

Example JSON response structure for the proxy list API. Includes proxy details, pagination information, and total counts.

```json
{
    "code": 200,
    "data": {
        "list": [
            {
                "id": "xx", // Proxy ID
                "name": "xx", // Name
                "host": "127.0.0.1",
                "port": "3001",
                "user": "user",
                "area": "US"
            }
        ],
        "page": 1,
        "pagesize": 10,
        "total": 1,
        "total_page": 1
    },
    "message": "Success"
}
```

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

### Cloud Phone Purchase Response Example

Source: https://help.duoplus.net/docs/Buy-Cloud-Phone

This is an example of a successful response when purchasing a Cloud Phone. It includes a status code, a success message, and the order ID.

```json
{
    "code": 200,
    "data": {
        "order_id": "xxxx"  // 	Order No
    },
    "message": "Success"
}
```

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

### Get Cloud Phone Status

Source: https://help.duoplus.net/docs/cloud-phone-status

Retrieves the status of one or more cloud phones. You need to provide a list of cloud phone IDs to get their current status.

```APIDOC
## POST /api/v1/cloudPhone/status

### Description
Get the status of cloud phones.

### Method
POST

### Endpoint
/api/v1/cloudPhone/status

### Parameters
#### Request Body
- **image_ids** (array) - Required - Cloud phone IDs

### Request Example
{
    "image_ids": ["xx"]
}

### Response
#### Success Response (200)
- **code** (integer) - HTTP status code.
- **data** (object) - Contains the list of cloud phone statuses.
  - **list** (array) - List of cloud phone status objects.
    - **id** (string) - Cloud phone ID.
    - **name** (string) - Cloud phone name.
    - **status** (integer) - Status code representing the cloud phone's state (0: Not configured, 1: Powered on, 2: Powered off, 3: Expired, 4: Renewal needed, 10: Powering on, 11: Configuring, 12: Configuration failed).
- **message** (string) - Success message.

#### Response Example
{
    "code": 200,
    "data": {
        "list": [
            {
                "id": "xx",
                "name": "xx",
                "status": 1
            }
        ]
    },
    "message": "Success"
}
```

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

### Platform App List Response Example

Source: https://help.duoplus.net/docs/List-of-Platform-App

The response includes a list of applications, pagination details (current page, items per page, total items, total pages), and a success message.

```json
{
    "code": 200,
    "data": {
        "list": [
            {
                "id": "9Jp7o#0", // app_id
                "name": "TikTok",
                "pkg": "com.zhiliaoapp.musically",
                "version_list": [
                    {
                        "id": "9Jp7o#0", // app_version_id
                        "name": "33.0.3"
                    },
                    {
                        "id": "QYAoK#0",
                        "name": "37.6.3"
                    }
                ]
            }
        ],
        "page": 1,
        "pagesize": 10,
        "total": 1,
        "total_page": 1
    },
    "message": "Success"
}
```

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

### Scheduled Task List Response Example

Source: https://help.duoplus.net/docs/scheduled-task-list

Example JSON response for the Scheduled Task List API. Includes task details, pagination information, and status codes.

```json
{
    "code": 200,
    "data": {
        "list": [
            {
                "id": "xxx",
                "name": "xxx",
                "task_type_name": "Official template",
                "image_name": "xxx",
                "ip": "xxx",
                "remark": "xxx",
                "status": 3,
                "issue_at": "2026-01-10 00:00",
                "start_at": "2026-01-13 13:04:01",
                "finish_at": "2026-01-13 13:07:19",
                "cost_time": 198,
                "execution_time": "2026-01-13 13:04~2026-01-13 13:07",
                "created_at": "2026-01-13 13:02:35"
            }
        ],
        "page": 1,
        "pagesize": 10,
        "total": 1,
        "total_page": 1
    },
    "message": "Success"
}
```

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

### List Platform Apps

Source: https://help.duoplus.net/docs/List-of-Platform-App

Retrieve the list of installable platform applications. Supports pagination with a default of 10 items per page and a maximum of 100 items per page. The 'page' parameter requests a specific page number, defaulting to the first page if not provided.

```APIDOC
## POST /api/v1/app/list

### Description
Retrieve the list of installable platform applications, supporting pagination with up to 100 items per page. Defaults to the first page and 10 items per page if not specified.

### Method
POST

### Endpoint
/api/v1/app/list

### Parameters
#### Query Parameters
- **page** (int) - Optional - Request the page number. If not provided, it defaults to the first page.
- **pagesize** (int) - Optional - Number of items per page. If not provided, it defaults to 10 items per page.

### Request Example
```json
{
    "page": 1,
    "pagesize": 100
}
```

### Response
#### Success Response (200)
- **code** (int) - HTTP status code.
- **data** (object) - Contains the list of applications and pagination details.
  - **list** (array) - An array of application objects.
    - **id** (string) - The unique identifier for the app.
    - **name** (string) - The name of the application.
    - **pkg** (string) - The package name of the application.
    - **version_list** (array) - A list of available versions for the application.
      - **id** (string) - The unique identifier for the app version.
      - **name** (string) - The version name.
  - **page** (int) - The current page number.
  - **pagesize** (int) - The number of items per page.
  - **total** (int) - The total number of applications available.
  - **total_page** (int) - The total number of pages available.
- **message** (string) - A message indicating the success of the operation.

#### Response Example
```json
{
    "code": 200,
    "data": {
        "list": [
            {
                "id": "9Jp7o#0",
                "name": "TikTok",
                "pkg": "com.zhiliaoapp.musically",
                "version_list": [
                    {
                        "id": "9Jp7o#0",
                        "name": "33.0.3"
                    },
                    {
                        "id": "QYAoK#0",
                        "name": "37.6.3"
                    }
                ]
            }
        ],
        "page": 1,
        "pagesize": 10,
        "total": 1,
        "total_page": 1
    },
    "message": "Success"
}
```
```

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

### Cloud Number Renewal Request Example

Source: https://help.duoplus.net/docs/Renew-Cloud-Numbers

Provides an example of the JSON payload for renewing cloud numbers. Ensure to query supported renewal durations before making this request.

```json
{
    "list": [
        {
            "number_ids": [
                "xxxx",
                "xxxx"
            ],
            "duration": 30
        },
        {
            "number_ids": [
                "xxxx"
            ],
            "duration": 29
        }
    ]
}
```

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

### Example Proxy Test Response

Source: https://help.duoplus.net/docs/Proxy-Detection-Failing

This is an example of the expected JSON output when the proxy test command is successful. It shows the IP address and location information obtained through the proxy.

```json
{
  "ip": "123.123.123.123",
  "city": "Atlanta",
  "region": "Georgia",
  "country": "US",
  "loc": "33.7490,-84.3880",
  "org": "AS5650 Frontier Communications of America, Inc.",
  "postal": "30394",
  "timezone": "America/New_York",
  "readme": "https://ipinfo.io/missingauth"
}
```

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

### Scheduled Task List Request Example

Source: https://help.duoplus.net/docs/scheduled-task-list

Example JSON payload for requesting a list of scheduled tasks. Supports filtering by ID, status, time ranges, and sorting options.

```json
{
    "page": 1,
    "pagesize": 10,
    "status": [0,3,4],
    "issue_at_start": "2026-01-01 00:00:00",
    "issue_at_end": "2026-01-01 23:59:59",
    "sort_by": "issue_at",
    "order": "desc",
    "id": "xxx",
    "name": "xxx",
    "template_type": [1],
    "image_name": "xxx",
    "image_ip": "xxx",
    "execution_at_start": "2026-01-01 00:00:00",
    "execution_at_end": "2026-01-23 23:59:59"
}
```

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

### Create Loop Task Request Example

Source: https://help.duoplus.net/docs/Create-Loop-Task

This JSON object demonstrates the structure for creating a loop task. It includes details for template selection, plan naming, image configurations with various data types (file, textarea, boolean, number, string, excel), and scheduling parameters like start/end times, execution frequency, and loop mode settings.

```json
{
    "template_id": "xxx",
    "template_type": "2",
    "name": "name",
    "remark": "remark",
    "images": [
        {
            "image_id": "xxx",
            "config": {
                "file": {
                    "key": "file",
                    "value": [
                        "L1ZVt",
                        "https://xxx/xxx.png"
                    ],
                    "type": "file",
                    "required": true
                },
                "text": {
                    "key": "text",
                    "value": "123\n456",
                    "type": "textarea",
                    "required": true
                },
                "bool": {
                    "key": "bool",
                    "value": "true",
                    "type": "boolean",
                    "required": true
                },
                "age": {
                    "key": "age",
                    "value": "18",
                    "type": "number",
                    "required": true
                },
                "name": {
                    "key": "name",
                    "value": "duoplus",
                    "type": "string",
                    "required": true
                },
                "email": {
                    "key": "email",
                    "value": "email1,email2",
                    "type": "excel",
                    "required": false
                },
                "password": {
                    "key": "password",
                    "value": "password1,passowrd2",
                    "type": "excel",
                    "required": false
                }
            },
            "start_at": "2025-12-11 17:38",
            "end_at": "2025-12-25 18:08",
            "execute_type": 4,
            "gap_time": 20,
            "execute_time": "15:11",
            "execute_end_time": "18:00",
            "mode": 2,
            "weeks": ["1","2","3","4","5"],
            "days": ["10","15","20","25"]
        }
    ]
}
```
Tokens:
Raw