API Documentation | VMOS Cloud API

Introduction

This document provides detailed API descriptions, syntax, parameter explanations, and examples, allowing you to manage cloud phone service resources through API calls.

API Overview

Instance Management

API	API Name	API Description
/vcpcloud/api/padApi/setWifiList	Modify Instance WIFI Properties	Modify the WIFI list properties of the specified instance
/vcpcloud/api/padApi/padDetails	Instance Details (Pending Launch)	Query the property information of the specified instance, including system properties and settings (Pending Launch)
/vcpcloud/api/padApi/restart	Instance Restart	Perform restart operation on the specified instance to resolve issues like system unresponsiveness or freezing
/vcpcloud/api/padApi/reset	Instance Reset	Perform reset operation on the instance, clearing all cloud instance data
/vcpcloud/api/padApi/padProperties	Query Instance Properties	Query the property information of the specified instance, including system properties and settings
/vcpcloud/api/padApi/batchPadProperties	Batch Query Instance Properties	Batch query the property information of specified instances, including system properties and settings
/vcpcloud/api/padApi/updatePadProperties	Modify Instance Properties	Dynamically modify instance properties, including system and settings
/vcpcloud/api/padApi/updatePadAndroidProp	Modify Instance Android Modification Properties	Static setting of Android modification properties, requires instance restart to take effect
/vcpcloud/api/padApi/updateSIM	Modify SIM Card Information Based on Country Code	Static setting of Android modification properties, randomly generates SIM info and restarts instance
/vcpcloud/api/padApi/dissolveRoom	Stop Streaming	Stop streaming for specified instance, disconnect connection
/vcpcloud/api/padApi/checkIP	Smart IP Proxy Detection	Detect if proxy IP is available and if location information is correct
/vcpcloud/api/padApi/smartIp	Set Smart IP	Set smart IP for cloud device; automatically change exit IP, SIM info, GPS, etc.
/vcpcloud/api/padApi/notSmartIp	Cancel Smart IP	Cancel smart IP, restore exit IP, SIM info, GPS, etc.
/vcpcloud/api/padApi/getTaskStatus	Device Task Execution Result Query	Query task execution result using task number (for smart IP)
/vcpcloud/api/padApi/getListInstalledApp	Get All Installed Apps in Specified Cloud Instance List	Get all installed apps in specified cloud instance list
/vcpcloud/api/padApi/updateTimeZone	Modify Instance Timezone	Modify instance timezone
/vcpcloud/api/padApi/updateLanguage	Modify Instance Language	Modify instance language
/vcpcloud/api/padApi/gpsInjectInfo	Set Instance Latitude and Longitude	Set instance latitude and longitude
/vcpcloud/open/network/proxy/info	Query Instance Proxy Information (Pending Launch)	Query instance proxy information (Pending Launch)
/vcpcloud/api/padApi/replacePad	One-Key New Device ⭐	One-key new device clears all current instance data and resets Android properties
/vcpcloud/api/padApi/country	Query One-Key New Device Supported Countries List	Query supported countries list for one-key new device
/vcpcloud/api/padApi/updateContacts	Update Contacts	Update contacts
/vcpcloud/api/padApi/setProxy	Instance Set Proxy	Set proxy information for specified instance
/vcpcloud/api/padApi/listInstalledApp	Real-Time Query Installed Apps List	Real-time query installed apps list
/vcpcloud/api/padApi/setKeepAliveApp	Set App Keep-Alive	Set app keep-alive (currently supports Android 13,14,15 only)
/vcpcloud/api/padApi/setHideAppList	Set App Hide (Pending Launch)	Send hide package list to specified instance (Pending Launch)
/vcpcloud/api/padApi/replaceRealAdiTemplate	Modify Real Device ADI Template	Modify cloud real device ADI template
/vcpcloud/api/padApi/asyncCmd	Async Execute ADB Commands	Async execute commands in one or more cloud instances
/vcpcloud/api/padApi/switchRoot	Switch Root Permissions	Switch root permissions in one or more cloud instances
/vcpcloud/api/padApi/screenshot	Local Screenshot	Instance screenshot
/vcpcloud/api/padApi/getLongGenerateUrl	Get Instance Real-Time Preview Image	Get current screen screenshot for specified instance
/vcpcloud/api/padApi/upgradeImage	Upgrade Image	Batch instance image upgrade
/vcpcloud/api/padApi/virtualRealSwitch	Upgrade Real Device Image	Batch real device image upgrade
/vcpcloud/api/padApi/templateList	Paginated Get Real Device Templates	Paginated retrieval of real device templates
/vcpcloud/api/padApi/adb	Get ADB Connection Information	Get ADB connection information
/vcpcloud/api/padApi/batch/adb	Batch Get ADB Connection Information (Pending Launch)	Batch get or disable ADB connection information (Pending Launch)
/vcpcloud/api/padApi/simulateTouch	Simulate Touch	Simulate touch events in instance via XY coordinates
/vcpcloud/api/padApi/padTaskDetail	Instance Operation Task Details	Query detailed execution results for specified instance operation task
/vcpcloud/api/padApi/executeScriptInfo	Get Instance Script Execution Result (Pending Launch)	Get script execution result via task ID (Pending Launch)
/vcpcloud/api/padApi/screenshotInfo	Get Instance Screenshot Result (Pending Launch)	Get instance screenshot result via task ID (Pending Launch)
/vcpcloud/api/padApi/padExecuteTaskInfo	Instance Restart/Reset Execution Result (Pending Launch)	Get restart/reset execution result via task ID (Pending Launch)
/vcpcloud/api/padApi/addPhoneRecord	Import Call Logs	Import call log data into cloud phone
/vcpcloud/api/padApi/inputText	Cloud Phone Text Input	Input specified text after focusing input box
/vcpcloud/api/padApi/simulateSendSms	Simulate Send SMS	Simulate sending SMS to instance
/vcpcloud/api/padApi/resetGAID	Reset GAID	Reset advertising ID in cloud phone
/vcpcloud/api/padApi/injectAudioToMic	Inject Audio to Instance Microphone	Inject audio file to instance microphone
/vcpcloud/api/padApi/localPodBackup	Create Local Instance Backup (Pending Launch)	Create backup for local instance (Pending Launch)
/vcpcloud/api/padApi/localPodRestore	Create Local Instance Restore (Pending Launch)	Restore from local instance backup (Pending Launch)
/vcpcloud/api/padApi/localPodBackupSelectPage	Local Instance Backup Query (Pending Launch)	Get available backups for local instance (Pending Launch)
/vcpcloud/api/padApi/cleanAppHome	Clear Processes and Return to Desktop (Pending Launch)	Clear all processes except system and return to desktop (Pending Launch)
/vcpcloud/api/padApi/unmannedLive	Unmanned Live Streaming	Instance video injection
/vcpcloud/api/padApi/injectPicture	Image Injection (Pending Launch)	Instance image injection (Pending Launch)
/vcpcloud/api/padApi/replacement	Device Replacement	Device replacement
[/vcpcloud/api/padApi/confirmTransfer](#Transfer Cloud Phone)	Transfer Cloud Phone	Transfer Cloud Phone

Resource Management

API Endpoint	API Name	API Description
/vcpcloud/api/padApi/infos	Instance List Information	Query information about all ordered instances.

Application Management

API Endpoint	API Name	API Description
/vcpcloud/api/padApi/installApp	Application Installation	Install and deploy a specified application to the specified cloud instance (asynchronous task).
/vcpcloud/api/padApi/startApp	Start App	Start App
/vcpcloud/api/padApi/stopApp	Stop App	Stop App
/vcpcloud/api/padApi/restartApp	Restart App	Restart App
/vcpcloud/api/padApi/listInstalledApp	Instance installed application list query	Query the list of installed applications for an instance
/vcpcloud/api/padApi/updateSIM	Modify sim card information according to country code	Modify sim card information according to country code
/vcpcloud/api/padApi/uploadFileV3	File upload interface directly through link	File upload interface directly through link
/vcpcloud/api/padApi/setKeepAliveApp	Set keepalive application interface	Set keepalive application interface
/vcpcloud/api/padApi/addUserRom	Upload user image	Upload user image

Task Management

API Endpoint	API Name	API Description
/vcpcloud/api/padApi/padTaskDetail	Instance Operation Task Details	Query detailed execution results of a specified instance operation task.
/vcpcloud/api/padApi/fileTaskDetail	File Task Details	Query detailed execution results of a specified file task.

Cloud Phone Management

API Endpoint	API Name	API Description
/vcpcloud/api/padApi/createMoneyOrder	Create Cloud Phone	Create a new cloud phone instance.
/vcpcloud/api/padApi/userPadList	Cloud Phone List	List of cloud phones.
/vcpcloud/api/padApi/padInfo	Cloud Phone Information Query	Query the information of a cloud phone instance.
/vcpcloud/api/padApi/getCloudGoodList	SKU Package List	List of SKU packages.
/vcpcloud/api/padApi/replaceRealAdiTemplate	Modify Real Machine ADI Template	Modify the ADI template of a physical machine.
/vcpcloud/api/padApi/createMoneyProOrder	Equipment Pre-sale Purchase	Equipment Pre-sale Purchase
/vcpcloud/api/padApi/queryProOrderList	Query pre-sale order result details	Query pre-sale order result details
/vcpcloud/api/padApi/imageVersionList	Android image version collection	Android image version collection
/vcpcloud/api/padApi/simulateTouch	Cloud machine simulated touch	Cloud machine simulated touch

TK Automation

API Endpoint	API Name	API Description
/vcpcloud/api/padApi/autoTaskList	Automated Task List Query	Query the list of automated tasks.
/vcpcloud/api/padApi/addAutoTask	Create Automation Task	Create a new automated task.
/vcpcloud/api/padApi/reExecutionAutoTask	Automated Task Retry	Retry an automated task.
/vcpcloud/api/padApi/cancelAutoTask	Automated Task Cancellationlation	Cancel an automated task.

SDK Token

API Endpoint	API Name	API Description
/vcpcloud/api/padApi/stsToken	Get SDK Temporary Token	Issue a temporary SDK token for user authentication of cloud phone services.
/vcpcloud/api/padApi/stsTokenByPadCode	Get SDK Temporary Token	Issue a temporary SDK token for user authentication of cloud phone services, based on pad code.
/vcpcloud/api/padApi/clearStsToken	Clear SDK Authorization Token	Clear the SDK authorization token.

OpenAPI Interface List

Instance Management

Modify Instance WIFI Properties

Modify the WIFI list properties of the specified instance (this interface and one-key new device WIFI setup are mutually exclusive, otherwise overwriting issues may occur)

API Endpoint

/vcpcloud/api/padApi/setWifiList

Request Method

POST

Request Content Type

application/json

Request Body Parameters

Parameter Name	Example Value	Type	Required	Description
padCodes		String[]	Yes	Instance codes
wifiJsonList		String[]	Yes	WIFI properties list
├─ SSID	110101	String	Yes	WIFI name (Chinese not supported)
├─ BSSID	02:31:00:00:00:01	String	Yes	Access point MAC address
├─ MAC	02:00:10:00:00:00	String	Yes	WIFI adapter MAC address
├─ IP	192.168.120.15	String	Yes	WIFI network IP
├─ gateway	192.168.120.1	String	Yes	WIFI gateway
├─ DNS1	1.1.1.1	String	Yes	DNS1
├─ DNS2	8.8.8.8	String	Yes	DNS2
├─ hessid	0	Integer	No	Network identifier
├─ anqpDomainId	0	Integer	No	ANQP (Access Network Query Protocol) domain ID
├─ capabilities	""	String	No	WPA/WPA2 etc. information
├─ level	0	Integer	No	Signal strength (RSSI)
├─ linkSpeed	500	Integer	No	Current Wi-Fi connection speed
├─ txLinkSpeed	600	Integer	No	Upload link speed
├─ rxLinkSpeed	700	Integer	No	Download link speed
├─ frequency	2134	Integer	No	Wi-Fi channel frequency
├─ distance	-1	Integer	No	Estimated AP distance
├─ distanceSd	-1	Integer	No	Estimated distance standard deviation
├─ channelWidth	0	Integer	No	Channel bandwidth
├─ centerFreq0	0	Integer	No	Center frequency 0
├─ centerFreq1	-1	Integer	No	Center frequency 1
├─ is80211McRTTResponder	false	Boolean	No	Whether supports 802.11mc (Wi-Fi RTT ranging technology)

Response Parameters

Parameter Name	Example Value	Type	Description
code	200	Integer	Status code
msg	success	String	Response message
ts	1756021167163	Long	Timestamp
data		Object
├─ taskId	1	Integer	Task ID
├─ padCode	AC2025030770R	String	Instance code
├─ vmStatus	1	Integer	Instance online status: 0-offline, 1-online

Request Example

{
    "padCodes":["AC2025030770R92X"],
    "wifiJsonList":[
        {
            "SSID": "110101",
            "BSSID": "02:31:00:00:00:01",
            "MAC": "02:00:10:00:00:00",
            "IP": "192.168.120.15",
            "gateway": "192.168.120.1",
            "DNS1": "1.1.1.1",
            "DNS2": "8.8.8.8",
            "hessid": 0,
            "anqpDomainId": 0,
            "capabilities": "",
            "level": 0,
            "linkSpeed": 500,
            "txLinkSpeed": 600,
            "rxLinkSpeed": 700,
            "frequency": 2413,
            "distance": -1,
            "distanceSd": -1,
            "channelWidth": 0,
            "centerFreq0": -1,
            "centerFreq1": -1,
            "is80211McRTTResponder": true
        }
    ]
}

Response Example

{
    "code": 200,
    "msg": "success",
    "ts": 1741676855566,
    "data": [
        {
            "taskId": 14904,
            "padCode": "AC2025030770R92X",
            "vmStatus": 0
        }
    ]
}

Instance Details

(Pending Launch)
Query the property information of the specified instance, including system properties and settings.

API Endpoint

/vcpcloud/api/padApi/padDetails

Request Method

POST

Request Content Type

application/json

Request Body Parameters

Parameter Name	Example Value	Type	Required	Description
padCodes		String[]	No
├─	AC21020010391	String	No	Instance code
padIps		String[]	No
├─	192.168.1.1	String	No	Instance IP
vmStatus	1	String	No	Instance online status: 0-offline, 1-online
controlStatus	1	String	No	Controlled status (streaming): 1-uncontrolled, 2-controlled
faultStatus	14	String	No	Instance running status: 14-abnormal, others-normal
deviceStatus	0	String	No	Physical machine online status: 0-offline, 1-online

Response Parameters

Parameter Name	Example Value	Type	Description
code	200	Integer	Status code
msg	success	String	Response message
ts	1756360093771	Long	Timestamp
traceId	ewc83bwudvr4	String	Trace ID
data		Object	Response data
├─ page	1	Integer	Current page
├─ rows	10	Integer	Records per page
├─ size	10	Integer	Current page count
├─ total	13398	Integer	Total records
├─ totalPage	1340	Integer	Total pages
├─ pageData		object[]	List
├─ ├─ padId	552	Long	Instance ID
├─ ├─ padCode	ACP250331GLMP7YX	String	Cloud instance code
├─ ├─ customerId	null	Long	Customer ID
├─ ├─ imageId	img-25032628136	String	Image ID
├─ ├─ deviceLevel	m2-6	String	Instance specification
├─ ├─ dcInfo		Object	Data center information
├─ ├─ ├─ id	1	Long	Data center ID
├─ ├─ ├─ dcName	小算测试-机房	String	Data center name
├─ ├─ ├─ dcCode	001	String	Data center code
├─ ├─ ├─ area	changsha	String	Region
├─ ├─ ├─ ossEndpoint	null	String	OSS public endpoint
├─ ├─ ├─ ossEndpointInternal	null	String	OSS internal endpoint
├─ ├─ ├─ ossFileEndpoint	null	String	File access endpoint
├─ ├─ ├─ ossScreenshotEndpoint	null	String	Screenshot access endpoint
├─ ├─ padStatus	15	Integer	Instance status (10-running, 11-restarting, 12-resetting, 13-upgrading, 14-abnormal, 15-not ready, 16-backing up, 17-restoring data, 18-shutdown, 19-shutting down, 20-booting, 21-shutdown failed, 22-boot failed, 23-deleting, 24-delete failed, 25-deleted, 26-cloning)
├─ ├─ deviceStatus	1	Integer	Physical machine status (0-offline, 1-online)
├─ ├─ online	0	Integer	Instance online status (0-offline, 1-online)
├─ ├─ streamStatus	0	Integer	Instance streaming status (0-idle, 1-streaming)
├─ ├─ dataSize	null	Long	Total storage capacity (bytes)
├─ ├─ dataSizeUsed	null	Long	Used storage capacity (bytes)
├─ ├─ adbOpenStatus	null	String	ADB switch status (1-enabled; empty/0-disabled)
├─ ├─ deviceIp	172.31.1.4	String	Board IP
├─ ├─ screenLayoutCode	multiple-portrait-basic	String	Screen layout code
├─ ├─ mac	""	String	MAC address
├─ ├─ netStorageResId	null	String	Net storage ID
├─ ├─ dns	192.168.50.15	String	Instance DNS
├─ ├─ memory	null	Integer	Memory size
├─ ├─ cpu	-1	Integer	CPU size
├─ ├─ socModel	MACS2080	String	SoC model
├─ ├─ netStorageResFlag	0	Integer	Net storage flag (1-net storage instance; 0-local instance)
├─ ├─ netStorageResSize	null	Long	Net storage instance size (GB)
├─ ├─ realPhoneTemplateId	389	Long	Real device template ID
├─ ├─ clusterCode	ZEG3650947	String	Cluster code
├─ ├─ padIp	null	String	Instance IP
├─ ├─ updateNetStorageResFlag	false	Boolean	Whether to specify net storage ID for boot
├─ ├─ targetStorageResId	null	String	Specified net storage ID
├─ ├─ armIp	192.168.200.50	String	ARM server IP
├─ ├─ countryCode	null	String	Country code
├─ ├─ type	virtual	String	Instance type (virtual-virtual machine / real-cloud real device)
├─ ├─ armServerId	179	Long	Server ID
├─ ├─ lastComputeUnitCode	null	String	Last boot compute unit code
├─ ├─ lastDeviceCode	null	String	Last boot device code
├─ ├─ lastDeviceIp	null	String	Last boot device IP
├─ ├─ cloneFlag	null	String	Clone flag (0-no, 1-yes)
├─ ├─ baseResUnitCode	null	String	Clone instance base storage code
├─ ├─ cbsInfo	2.0.14	String	CBS information
├─ ├─ firstBoot	true	Boolean	Whether first boot

Request Example

{
 "page": 1,
 "rows": 10,
 "padCodes": ["AC21020010391"],
 "padIps":["192.168.1.1"],
 "vmStatus":"1",
 "controlStatus":"1",
 "faultStatus":"14",
 "deviceStatus":"0"
}

Response Example

{
    "code": 200,
    "msg": "success",
    "ts": 1756360093771,
    "data": {
        "page": 1,
        "rows": 10,
        "size": 10,
        "total": 13398,
        "totalPage": 1340,
        "pageData": [
            {
                "padId": 552,
                "padCode": "ACP250331GLMP7YX",
                "customerId": null,
                "imageId": "img-25032628136",
                "deviceLevel": "m2-6",
                "dcInfo": {
                    "id": 1,
                    "dcName": "小算测试-机房",
                    "dcCode": "001",
                    "area": "changsha",
                    "ossEndpoint": null,
                    "ossEndpointInternal": null,
                    "ossFileEndpoint": null,
                    "ossScreenshotEndpoint": null
                },
                "padStatus": 15,
                "deviceStatus": 1,
                "online": 0,
                "streamStatus": 0,
                "dataSize": null,
                "dataSizeUsed": null,
                "adbOpenStatus": null,
                "deviceIp": "172.31.1.4",
                "screenLayoutCode": "multiple-portrait-basic",
                "mac": "",
                "netStorageResId": null,
                "dns": "192.168.50.15",
                "memory": null,
                "cpu": -1,
                "socModel": "MACS2080",
                "netStorageResFlag": 0,
                "netStorageResSize": null,
                "realPhoneTemplateId": 389,
                "clusterCode": "ZEG3650947",
                "padIp": null,
                "updateNetStorageResFlag": false,
                "targetStorageResId": null,
                "armIp": "192.168.200.50",
                "countryCode": null,
                "type": "virtual",
                "armServerId": 179,
                "lastComputeUnitCode": null,
                "lastDeviceCode": null,
                "lastDeviceIp": null,
                "cloneFlag": null,
                "baseResUnitCode": null,
                "cbsInfo": "2.0.14",
                "firstBoot": true
            }
        ]
    },
    "traceId": "ewc83bwudvr4"
}

Instance Restart

Perform restart operation on the specified instance to resolve issues like system unresponsiveness or freezing.

API Endpoint

/vcpcloud/api/padApi/restart

Request Method

POST

Request Content Type

application/json

Request Body Parameters

Parameter Name	Example Value	Type	Required	Description
padCodes		String[]	Yes
├─	AC21020010001	String	Yes	Instance code

Response Parameters

Parameter Name	Example Value	Type	Description
code	200	Integer	Status code
msg	success	String	Response message
ts	1756021167163	Long	Timestamp
data		Object[]
├─ taskId	1	Integer	Task ID
├─ padCode	AC21020010001	String	Instance code
├─ vmStatus	1	Integer	Instance online status (0: offline; 1: online)
├─ taskStatus	1	Integer	Task status (-1: task exists, do not resubmit; 1: task added)

Request Example

{
 "padCodes": [
  "AC22030022693"
 ]
}

Response Example

{
    "code": 200,
    "msg": "success",
    "ts": 1756313806284,
    "data": [
        {
            "taskId": 4844869,
            "padCode": "ATP250818261XVMO",
            "vmStatus": 0,
            "taskStatus": 1
        }
    ],
    "traceId": "ewab9x88fkzk"
}

Error Codes

Error Code	Error Description	Suggestion
10001	Restart failed	Contact administrator
110004	Restart command execution failed	Restart later
110028	Instance does not exist	Check if instance exists

Instance Reset

Note: Instance reset clears all system data. Use with caution. After each reset, the public IP will be restored to default. Perform reset operation on the instance, clearing all cloud instance data.

API Endpoint

/vcpcloud/api/padApi/reset

Request Method

POST

Request Content Type

application/json

Request Body Parameters

Parameter Name	Example Value	Type	Required	Description
padCodes		String[]	Yes
├─	AC21020010001	String	Yes	Instance code

Response Parameters

Parameter Name	Example Value	Type	Description
code	200	Integer	Status code
msg	success	String	Response message
ts	1756021167163	Long	Timestamp
data		Object[]
├─ taskId	1	Integer	Task ID
├─ padCode	AC21020010001	String	Instance code
├─ vmStatus	1	Integer	Instance online status (0: offline; 1: online)
├─ taskStatus	1	Integer	Task status (-1: task exists, do not resubmit; 1: task added)

Request Example

{
 "padCodes": [
  "AC21020010001"
 ]
}

Response Example

{
    "code": 200,
    "msg": "success",
    "ts": 1756313781715,
    "data": [
        {
            "taskId": 760459892,
            "padCode": "ATP250817PIJLWRP",
            "vmStatus": 0,
            "taskStatus": 1
        }
    ],
    "traceId": "ewab8lv65yio"
}

Error Codes

Error Code	Error Description	Suggestion
10002	Reset failed	Contact administrator
110005	Reset command execution failed	Reset later

Query Instance Properties

Query the property information of the specified instance, including system properties and settings.

API Endpoint

/vcpcloud/api/padApi/padProperties

Request Method

POST

Request Content Type

application/json

Request Body Parameters

Parameter Name	Example Value	Type	Required	Description
padCode	AC21020010001	String	Yes	Instance code

Response Parameters

Parameter Name	Example Value	Type	Description
code	200	Integer	Status code
msg	success	String	Response message
ts	1756021167163	Long	Timestamp
data		Object
├─ padCode	AC21020010001	String	Instance code
├─ modemPropertiesList		Object[]	Modem properties list
├─ ├─ propertiesName	IMEI	String	Property name
├─ ├─ propertiesValue	412327621057784	String	Property value
├─ systemPropertiesList		Object[]	System properties list
├─ ├─ propertiesName	ro.build.id	String	Property name
├─ ├─ propertiesValue	QQ3A.200805.001	String	Property value
├─ settingPropertiesList		Object[]	Setting properties list
├─ ├─ propertiesName	ro.build.tags	String	Property name
├─ ├─ propertiesValue	release-keys	String	Property value
├─ oaidPropertiesList		Object[]	OAID properties list
├─ ├─ propertiesName	oaid	String	Property name
├─ ├─ propertiesValue	001	String	Property value

Request Example

{
 "padCode": "AC21020010001"
}

Response Example

{
 "code": 200,
 "msg": "success",
 "ts":1713773577581,
 "data": {
  "padCode": "AC21020010001",
  "modemPropertiesList": [
   {
    "propertiesName": "IMEI",
    "propertiesValue": "412327621057784"
   }
  ],
  "systemPropertiesList": [
   {
    "propertiesName": "ro.build.id",
    "propertiesValue": "QQ3A.200805.001"
   }
  ],
  "settingPropertiesList": [
   {
    "propertiesName": "ro.build.tags",
    "propertiesValue": "release-keys"
   }
  ],
  "oaidPropertiesList": [
   {
    "propertiesName": "oaid",
    "propertiesValue": "001"
   }
  ]
 }
}

Error Codes

Error Code	Error Description	Suggestion
110028	Instance does not exist	Check if instance is correct

Batch Query Instance Properties

Batch query the property information of specified instances, including system properties and settings.

API Endpoint

/vcpcloud/api/padApi/batchPadProperties

Request Method

POST

Request Content Type

application/json

Request Body Parameters

Parameter Name	Example Value	Type	Required	Description
padCodes		String[]	Yes	Instance count not exceeding 200
├─	AC21020010001	String	Yes	Instance code
├─	AC21020010002	String	Yes	Instance code

Response Parameters

Parameter Name	Example Value	Type	Description
code	200	Integer	Status code
msg	success	String	Response message
ts	1756021167163	Long	Timestamp
data		Object[]
├─ padCode	AC21020010001	String	Instance code
├─ modemPropertiesList		Object[]	Modem properties list
├─ ├─ propertiesName	IMEI	String	Property name
├─ ├─ propertiesValue	412327621057784	String	Property value
├─ systemPropertiesList		Object[]	System properties list
├─ ├─ propertiesName	ro.build.id	String	Property name
├─ ├─ propertiesValue	QQ3A.200805.001	String	Property value
├─ settingPropertiesList		Object[]	Setting properties list
├─ ├─ propertiesName	ro.build.tags	String	Property name
├─ ├─ propertiesValue	release-keys	String	Property value
├─ oaidPropertiesList		Object[]	OAID properties list
├─ ├─ propertiesName	oaid	String	Property name
├─ ├─ propertiesValue	001	String	Property value

Request Example

{
    "padCodes": [
        "AC21020010001",
        "AC21020010002"
    ]
}

Response Example

{
 "code": 200,
 "msg": "success",
 "ts":1713773577581,
 "data": [
        {
            "padCode": "AC21020010001",
            "modemPropertiesList": [
                {
                    "propertiesName": "IMEI",
                    "propertiesValue": "412327621057784"
                }
            ],
            "systemPropertiesList": [
                {
                    "propertiesName": "ro.build.id",
                    "propertiesValue": "QQ3A.200805.001"
                }
            ],
            "settingPropertiesList": [
                {
                    "propertiesName": "ro.build.tags",
                    "propertiesValue": "release-keys"
                }
            ],
            "oaidPropertiesList": [
                {
                    "propertiesName": "oaid",
                    "propertiesValue": "001"
                }
            ]
        },
        {
            "padCode": "AC21020010002",
            "modemPropertiesList": [
                {
                    "propertiesName": "IMEI",
                    "propertiesValue": "412327621057784"
                }
            ],
            "systemPropertiesList": [
                {
                    "propertiesName": "ro.build.id",
                    "propertiesValue": "QQ3A.200805.001"
                }
            ],
            "settingPropertiesList": [
                {
                    "propertiesName": "ro.build.tags",
                    "propertiesValue": "release-keys"
                }
            ],
            "oaidPropertiesList": [
                {
                    "propertiesName": "oaid",
                    "propertiesValue": "001"
                }
            ]
        }
    ]
}

Error Codes

Error Code	Error Description	Suggestion
110028	Instance does not exist	Check if instance is correct

Modify Instance Properties

Dynamically modify instance properties, including system and settings.
Instance must be powered on; this interface takes effect immediately.
Refer to Instance Properties List

API Endpoint

/vcpcloud/api/padApi/updatePadProperties

Request Method

POST

Request Content Type

application/json

Request Body Parameters

Parameter Name	Example Value	Type	Required	Description
padCodes		String[]	Yes
├─	AC21020010001	String	Yes	Instance code
modemPersistPropertiesList		Object[]	No	Modem persistent properties list
├─ propertiesName	IMEI	String	No	Property name
├─ propertiesValue	412327621057784	String	No	Property value
modemPropertiesList		Object[]	No	Modem non-persistent properties list
├─ propertiesName	IMEI	String	No	Property name
├─ propertiesValue	412327621057784	String	No	Property value
systemPersistPropertiesList		Object[]	No	System persistent properties list
├─ propertiesName	ro.build.id	String	No	Property name
├─ propertiesValue	QQ3A.200805.001	String	No	Property value
systemPropertiesList		Object[]	No	System non-persistent properties list
├─ propertiesName	ro.build.id	String	No	Property name
├─ propertiesValue	QQ3A.200805.001	String	No	Property value
settingPropertiesList		Object[]	No	Setting properties list
├─ propertiesName	ro.build.tags	String	No	Property name
├─ propertiesValue	release-keys	String	No	Property value
oaidPropertiesList		Object[]	No	OAID properties list
├─ propertiesName	oaid	String	No	Property name
├─ propertiesValue	001	String	No	Property value

Response Parameters

Parameter Name	Example Value	Type	Description
code	200	Integer	Status code
msg	success	String	Response message
ts	1756021167163	Long	Timestamp
data		Object[]
├─ taskId	1	Integer	Task ID
├─ padCode	AC21020010001	String	Instance code
├─ vmStatus	1	Integer	Instance online status (0: offline; 1: online)

Request Example

{
 "padCodes": [
  "AC21020010001"
 ],
 "modemPersistPropertiesList": [
   {
    "propertiesName": "IMEI",
    "propertiesValue": "412327621057784"
   }
  ],
 "modemPropertiesList": [
   {
    "propertiesName": "IMEI",
    "propertiesValue": "412327621057784"
   }
  ],
  "systemPersistPropertiesList": [
   {
    "propertiesName": "ro.build.id",
    "propertiesValue": "QQ3A.200805.001"
   }
  ],
  "systemPropertiesList": [
   {
    "propertiesName": "ro.build.id",
    "propertiesValue": "QQ3A.200805.001"
   }
  ],
  "settingPropertiesList": [
   {
    "propertiesName": "ro.build.tags",
    "propertiesValue": "release-keys"
   }
  ],
  "oaidPropertiesList": [
   {
    "propertiesName": "oaid",
    "propertiesValue": "001"
   }
  ]
}

Response Example

{
 "code": 200,
 "msg": "success",
 "ts": 1717570916196,
 "data": [
  {
   "taskId": 36,
   "padCode": "AC22030010001",
   "vmStatus": 1
  }
 ]
}

Error Codes

Error Code	Error Description	Suggestion
110011	Modify property command failed	Retry later
110028	Instance does not exist	Check instance
110027	Duplicate instances in list	Check duplicates

Modify Instance Android Modification Properties

Static setting of Android modification properties, requires instance restart to take effect, generally used for modifying device information.
Difference from [Modify Instance Properties]: this takes effect on each boot initialization.
Properties are persistently stored; no need to call again after restart or reset.
Refer to Android Modification Properties List
Requires understanding of Android system. Some properties may affect normal boot. If abnormal after modification, reset instance to recover.

API Endpoint

/vcpcloud/api/padApi/updatePadAndroidProp

Request Method

POST

Request Content Type

application/json

Request Body Parameters

Parameter Name	Example Value	Type	Required	Description
padCode	AC32010210001	String	No	Instance ID
restart	false	Boolean	No	Auto restart after setting (default false)
props	{}	Object	Yes	System properties (key-value)
├─ ro.product.vendor.name	OP52D1L1	String	Yes	Property setting

Response Parameters

Parameter Name	Example Value	Type	Description
code	200	Integer	Status code
msg	success	String	Response message
ts	1756021167163	Long	Timestamp
data		Object
├─ taskId	24	Long	Task ID
├─ padCode	AC32010210001	String	Instance ID
├─ taskStatus	1	Integer	Task status (-1: task exists, do not resubmit; 1: task added)

Request Example

{
 "padCode": "AC32010210001",
 "props": {
  "ro.product.vendor.name": "OP52D1L1"
 },
 "restart": false
}

Response Example

{
    "code": 200,
    "msg": "success",
    "ts": 1756313781338,
    "data": {
        "taskId": 760459884,
        "padCode": "AC32010160134",
        "vmStatus": 0,
        "taskStatus": 1
    },
    "traceId": "ewab8l4lqu4g"
}

Modify SIM Card Information Based on Country Code

Static setting of Android modification properties, requires instance restart to take effect, generally used for modifying device information.
Same function as [Modify Instance Android Modification Properties], difference: randomly generates SIM info and always restarts.
Properties persistently stored.

API Endpoint

/vcpcloud/api/padApi/updateSIM

Request Method

POST

Request Content Type

application/json

Request Body Parameters

Parameter Name	Example Value	Type	Required	Description
padCode	AC32010210001	String	Yes	Instance ID
countryCode	US	String	No	Country code
props	{}	Object	No	System properties (key-value)
├─ ro.product.vendor.name	OP52D1L1	String	No	Property setting

Response Parameters

Parameter Name	Example Value	Type	Description
code	200	Integer	Status code
msg	success	String	Response message
ts	1756360113813	Long	Timestamp
traceId	ewc84g8si0oy	String	Trace ID
data		Object	Response data
├─ taskId	10002486	Long	Task ID
├─ padCode	ACN342712020172800	String	Instance code
├─ vmStatus	0	Integer	Instance online status (0: offline; 1: online)
├─ taskStatus	1	Integer	Task status (-1: task exists, do not resubmit; 1: task added)

Request Example

{
    "padCode": "AC32010250001",
    "props": {
        "persist.sys.cloud.phonenum": "1234578998"
    },
    "countryCode": "US"
}

Response Example 1

{
    "code": 200,
    "msg": "success",
    "ts": 1756360113813,
    "data": {
        "taskId": 10002486,
        "padCode": "ACN342712020172800",
        "vmStatus": 0,
        "taskStatus": 1
    },
    "traceId": "ewc84g8si0oy"
}

Response Example 2

{
   "code": 500,
   "msg": "Currently not supporting country code: XX",
   "ts": 1753521350163,
   "data": null
}

Error Codes

Error Code	Error Description	Suggestion
110065	Invalid request parameters, refer to documentation	Check parameters
110028	Instance does not exist	Check instance code

Stop Streaming

Stop streaming for specified instance, disconnect connection.

API Endpoint

/vcpcloud/api/padApi/dissolveRoom

Request Method

POST

Request Content Type

application/json

Request Body Parameters

Parameter Name	Example Value	Type	Required	Description
padCodes		String[]	Yes
├─	AC11010000031	String	Yes	Instance code
├─	AC22020020700	String	Yes	Instance code

Response Parameters

Parameter Name	Example Value	Type	Description
code	200	Integer	Status code
msg	success	String	Response message
ts	1756021167163	Long	Timestamp
traceId	ewc84g8si0oy	String	Trace ID
data		Object[]
├─ successList		Object[]	Success list
├─ ├─ padCode	AC11010000031	String	Instance code
├─ failList		Object[]	Failure list
├─ ├─ padCode	AC22020020700	String	Instance code
├─ ├─ errorCode	120005	Integer	Error code
├─ ├─ errorMsg	Instance does not exist	String	Failure reason

Request Example

{
    "padCodes": ["AC11010000031","AC22020020700"]
}

Response Example

{
 "code": 200,
 "msg": "success",
 "ts":1713773577581,
 "data": {
     "successList": [
              {
                  "padCode": "AC11010000031"
              }
          ],
          "failList": [
      {
                  "padCode": "AC22020020700",
      "errorCode": 120005,
      "errorMsg": "实例不存在"
              }
    ]
     },
    "traceId": "ewab9njt3gn4"
}

Error Codes

Error Code	Error Description	Suggestion
120005	Instance does not exist	Check instance code
120004	Stop streaming error, service abnormal	Retry later

Smart IP Proxy Detection

Detect if proxy IP is available and if location information is correct.

API Endpoint

/vcpcloud/api/padApi/checkIP

Request Method

POST

Request Content Type

application/json

Request Body Parameters

Parameter Name	Example Value	Type	Required	Description
host	127.0.0.1	String	Yes	Proxy info (IP or host)
port	8080	Integer	Yes	Proxy port (numeric)
account	xxxx	String	Yes	Proxy username
password	xxxx	String	Yes	Proxy password
type	Socks5	String	Yes	Proxy protocol: Socks5, http, https
country	US	String	No	Country - required when forcing specification
ip	156.228.84.62	String	No	IP - required when forcing
loc	39.0438,-77.4874	String	No	Latitude, longitude - required when forcing
city	Ashburn	String	No	City - required when forcing
region	Virginia	String	No	Region - required when forcing
timezone	America/New_York	String	No	Timezone - required when forcing

Response Parameters

Parameter Name	Example Value	Type	Description
code	200	Integer	Status code
msg	success	String	Response message
ts	1721739857317	Long	Timestamp
data		Object[]
├─ proxyLocation	US-Los Angeles	String	Location
├─ publicIp	62.112.132.92	String	Exit IP
├─ proxyWorking	true	Boolean	Detection success - true, failure - false

Request Example

{
    "host": "62.112.132.92",
    "port": 45001,
    "account": "xxxxxxxxxx",
    "password": "xxxxxxxx",
    "type": "Socks5"
    // "country": "US"，
    // "ip": "156.228.84.62",
    // "loc": "39.0438,-77.4874",
    // "city": "Ashburn",
    // "region": "Virginia",
    // "timezone": "America/New_York"
}

Response Example

{
    "msg": "success",
    "code": 200,
    "data": {
        "proxyLocation": "US-Los Angeles",
        "publicIp": "62.112.132.92",
        "proxyWorking": true
    },
    "ts": 1737601218580
}

Set Smart IP

Set smart IP for cloud device; exit IP, SIM info, GPS coordinates, timezone etc. automatically change to proxy's country (device restarts after setting, takes effect within 1 minute after restart; status changes to 119-initializing; returns to 100-normal on success/failure/timeout; timeout 5 minutes).

(Smart IP must be detected first via detection interface) Direct setting may cause country mismatch.

API Endpoint

/vcpcloud/api/padApi/smartIp

Request Method

POST

Request Content Type

application/json

Request Body Parameters

Parameter Name	Example Value	Type	Required	Description
padCodes		String[]	Yes
├─	AC22030010182	String	Yes	Instance code
host	127.0.0.1	String	Yes	Proxy info (IP or host)
port	8080	Integer	Yes	Proxy port
account	xxxx	String	Yes	Proxy username
password	xxxx	String	Yes	Proxy password
type	Socks5	String	Yes	Proxy protocol: Socks5, http, https
mode	vpn	String	Yes	Proxy mode: vpn / proxy

Response Parameters

Parameter Name	Example Value	Type	Description
code	200	Integer	Status code
data	TASK-278784482960609280	String	Task number
msg	success	String	Response message
ts	1721739857317	Long	Timestamp

Request Example

{
    "padCodes": [
        "AC32010160334"
    ],
    "host": "62.112.132.92",
    "port": 45001,
    "account": "xxxxxx",
    "password": "xxxxxxx",
    "type": "Socks5",
    "mode": "vpn"
}

Response Example

{
    "msg": "success",
    "code": 200,
    "data": "TASK-278784482960609280",
    "ts": 1737604726812
}

Cancel Smart IP

Cancel smart IP, restore exit IP, SIM info, GPS, timezone (device restarts, takes effect within 1 minute; status 119-initializing; returns to 100-normal on success/failure/timeout; timeout 5 minutes).

API Endpoint

/vcpcloud/api/padApi/notSmartIp

Request Method

POST

Request Content Type

application/json

Request Body Parameters

Parameter Name	Example Value	Type	Required	Description
padCodes		String[]	Yes
├─	AC22030010182	String	Yes	Instance code

Response Parameters

Parameter Name	Example Value	Type	Description
code	200	Integer	Status code
data	TASK-278784482960609280	String	Task number
msg	success	String	Response message
ts	1721739857317	Long	Timestamp

Request Example

{
    "padCodes": [
        "AC32010160334"
    ]
}

Response Example

{
    "msg": "success",
    "code": 200,
    "data": "TASK-278784482960609280",
    "ts": 1737604726812
}

Device Task Execution Result Query

Query task execution result using task number (for smart IP).

API Endpoint

/vcpcloud/api/padApi/getTaskStatus

Request Method

POST

Request Content Type

application/json

Request Body Parameters

Parameter Name	Example Value	Type	Required	Description
taskId	TASK-278784482960609280	String	Yes	Task ID

Response Parameters

Parameter Name	Example Value	Type	Description
code	200	Integer	Status code
data		Object[]	Task results
├─ padCode	AC32010150162	String	Instance code
├─ taskStatus	Successfully	String	Task status: Executing-in progress, Successfully-success, Failed-failure, Timedout-timeout
├─ taskType	10010	Integer	Task type: 10010-set smart IP, 10011-cancel smart IP
msg	success	String	Response message
ts	1721739857317	Long	Timestamp

Request Example

{
    "taskId": "TASK-278784482960609280"
}

Response Example

{
    "msg": "success",
    "code": 200,
    "data": [
        {
            "padCode": "AC32010150162",
            "taskStatus": "Successfully",
            "taskType": 10010
        }
    ],
    "ts": 1738999472135
}

Get All Installed Apps in Specified Cloud Instance List

API Endpoint

/vcpcloud/api/padApi/getListInstalledApp

Request Method

POST

Request Content Type

application/json

Request Body Parameters

Parameter Name	Example Value	Type	Required	Description
padCodeList		String[]	Yes
├─	AC22020020793	String	Yes	Instance code

Response Parameters

Parameter Name	Example Value	Type	Description
code	200	Integer	Status code
msg	success	String	Response message
ts	1721739857317	Long	Timestamp
data		Object[]
├─ appName	VMOSCloud	String	App name
├─ packageName	com.geniuscloud.overseas	String	Package name

Request Example

{
    "padCodeList": ["AC32010601132"]
}

Response Example

{
    "msg": "success",
    "code": 200,
    "data": [
        {
            "appName": "VMOSCloud",
            "packageName": "com.geniuscloud.overseas"
        },
        {
            "appName": "快手极速版",
            "packageName": "com.kuaishou.nebula"
        }
    ],
    "ts": 1746694111364
}

File Upload via Link Directly

Push file from file management center to cloud phone instance (async task). If file found by md5 or file ID, directly use OSS path for download. If not in OSS, send URL for download and upload content to OSS. If auto install app, check package name; if empty, throw exception. (Auto install grants all permissions by default; use isAuthorization to disable).

API Endpoint

/vcpcloud/api/padApi/uploadFileV3

Request Method

POST

Request Content Type

application/json

Request Body Parameters

Parameter Name	Example Value	Type	Required	Description
padCodes		String[]	Yes
├─ padCode	AC32010250011	String	No	Instance code
autoInstall	1	Integer	No	Auto install: 1-yes, 0-no (default no). Only for APK
fileUniqueId	1e5d3bf00576ee8f3d094908c0456722	String	No	File unique ID
customizeFilePath	/Documents/	String	No	Custom path (start with /, e.g. "/DCIM/", "/Documents/" etc.)
fileName	threads	String	No	File name
packageName	com.zhiliaoapp.musically	String	No	Package name
url	https://file.vmoscloud.com/appMarket/2/apk/fe1f75df23e6fe3fd3b31c0f7f60c0af.apk	String	No	File URL
md5	1e5d3bf00576ee8f3d094908c0456722	String	No	File MD5
isAuthorization	false	Boolean	No	Grant permissions (default all)
iconPath	https://file.vmoscloud.com/appMarket/2/apk/fe1f75df23e6fe3fd3b31c0f7f60c0af.png	String	No	Icon for install

Response Parameters

Parameter Name	Example Value	Type	Description
code	200	Integer	Status code
msg	success	String	Response message
ts	1721739857317	Long	Timestamp
data		Object[]
├─ padCode	AC22010020062	String	Instance code
├─ taskId	1	Integer	Task ID
├─ vmStatus	1	Integer	Instance online status (0: offline; 1: online)

Request Example

{
    "padCodes": [
        "AC32010250022"
    ],
    "customizeFilePath": "/DCIM/",
    "md5": "d97fb05b3a07d8werw2341f10212sdfs3sdfs24",
    "url": "https://file.vmoscloud.com/appMarket/2/apk/fe1f75df23e6fe3fd3b31c0f7f60c0af.apk",
    "autoInstall": 1,
    "packageName": "com.zhiliaoapp.musically",
    "fileName": "market",
    "isAuthorization": false
}

Response Example

{
    "code": 200,
    "msg": "success",
    "ts": 1737431505379,
    "data": [
        {
            "taskId": 13469,
            "padCode": "AC32010250022",
            "vmStatus": 0
        }
    ]
}

Error Codes

Error Code	Error Description	Suggestion
110065	Invalid request parameters	Check parameters, refer to doc
120005	Instance does not exist	Check instance code

Modify Instance Timezone

API Endpoint

/vcpcloud/api/padApi/updateTimeZone

Request Method

POST

Request Content Type

application/json

Request Body Parameters

Parameter Name	Example Value	Type	Required	Description
timeZone	Asia/Shanghai	String	Yes	UTC standard timezone
padCodes		Array	Yes	Instance list

Response Parameters

Parameter Name	Example Value	Type	Description
code	200	Integer	Status code
msg	success	String	Response message
ts	1756021167163	Long	Timestamp
traceId	ewc84g8si0oy	String	Trace ID
data		Object
├─ taskId	24	Long	Task ID
├─ padCode	AC22030010001	String	Instance code
├─ vmStatus		Integer	Instance online status (0: offline; 1: online)
├─ taskStatus	1	Integer	Task status (-1: task exists; 1: added)

Request Example

{
 "padCodes": [
  "AC32010140003"
 ],
 "timeZone": "Asia/Shanghai"
}

Response Example

{
    "code": 200,
    "msg": "success",
    "ts": 1756313802157,
    "data": [
        {
            "taskId": 760460229,
            "padCode": "ACP250417QAGGQ3S",
            "vmStatus": 0,
            "taskStatus": 1
        }
    ],
    "traceId": "ewab9p712ww0"
}

Modify Instance Language

API Endpoint

/vcpcloud/api/padApi/updateLanguage

Request Method

POST

Request Content Type

application/json

Request Body Parameters

Parameter Name	Example Value	Type	Required	Description
language	zh	String	Yes	Language
country	CN	String	No	Country
padCodes		Array	Yes	Instance list

Response Parameters

Parameter Name	Example Value	Type	Description
code	200	Integer	Status code
msg	success	String	Response message
ts	1756021167163	Long	Timestamp
traceId	ewc84g8si0oy	String	Trace ID
data		Object
├─ taskId	24	Long	Task ID
├─ padCode	AC22030010001	String	Instance code
├─ vmStatus		Integer	Instance online status (0: offline; 1: online)
├─ taskStatus	1	Integer	Task status (-1: task exists; 1: added)

Request Example

{
 "padCodes": [
  "AC32010140026"
 ],
 "language": "zh",
 "country": ""
}

Response Example

{
 "code": 200,
 "msg": "success",
 "ts": 1717570663080,
 "traceId": "ewab9p712ww0",
 "data": [
  {
   "taskId": 24,
   "padCode": "AC32010140026",
   "vmStatus": 1,
      "taskStatus": 1
  }
 ]
}

Set Instance Latitude and Longitude

API Endpoint

/vcpcloud/api/padApi/gpsInjectInfo

Request Method

POST

Request Content Type

application/json

Request Body Parameters

Parameter Name	Example Value	Type	Required	Description
longitude	116.397455	Float	Yes	Longitude
latitude	39.909187	Float	Yes	Latitude
altitude	8	Float	No	Altitude (requires latest image)
speed	8	Float	No	Speed m/s (images after 20251024)
bearing	0	Float	No	Bearing ° (images after 20251024)
horizontalAccuracyMeters	0.1	Float	No	Horizontal accuracy (images after 20251024)
padCodes		Array	Yes	Instance list

Response Parameters

Parameter Name	Example Value	Type	Description
code	200	Integer	Status code
traceId	ewc84g8si0oy	String	Trace ID
msg	success	String	Response message
ts	1756021167163	Long	Timestamp
data		Boolean

Request Example

{
 "padCodes": [
  "AC32010030001"
 ],
 "longitude": 116.397455,
 "latitude": 39.909187,
 "altitude": 8
}

Response Example

{
 "code": 200,
 "msg": "success",
 "ts": 1717570663080,
 "traceId": "ewab9p712ww0",
 "data": true
}

Query Instance Proxy Information

(Pending Launch)

API Endpoint

/vcpcloud/open/network/proxy/info

Request Method

POST

Request Content Type

application/json

Request Body Parameters

Parameter Name	Example Value	Type	Required	Description
padCodes		Array	Yes	Instance list

Response Parameters

Parameter Name	Example Value	Type	Description
code	200	Integer	Status code
msg	success	String	Response message
ts	1756021167163	Long	Timestamp
traceId	ewc84g8si0oy	String	Trace ID
data		Object
├─ taskId	24	Long	Task ID
├─ padCode	AC22030010001	String	Instance code
├─ vmStatus		Integer	Instance online status (0: offline; 1: online)
├─ taskStatus	1	Integer	Task status (-1: task exists; 1: added)

Request Example

{
  "padCodes": [
    "AC32010140012"
  ]
}

Response Example

{
    "code": 200,
    "msg": "success",
    "ts": 1756348835040,
    "data": [
        {
            "taskId": 14294,
            "padCode": "ACP250820SBM4NEU",
            "vmStatus": 0,
            "taskStatus": 1
        }
    ],
    "traceId": "ewbrcry0frb4"
}

One-Key New Device ⭐

Note: One-key new device clears all system data. Use with caution! One-key new device clears all current instance data and resets Android properties.

Virtual machine: directly set Android properties, clear all data
Cloud real device: clear all data (equivalent to reset), add SIM info; if template ID provided, replace ADI template. If no template and replacementRealAdiFlag true, randomly select template.
Note: If no country info or unsupported, default Singapore SIM.
Unsupported country returns 500 error: Currently not supporting country code XX

API Endpoint

/vcpcloud/api/padApi/replacePad

Request Method

POST

Request Content Type

application/json

Request Body Parameters

Parameter Name	Example Value	Type	Required	Description
padCodes	[]	Array	Yes	Instance ID list
countryCode	SG	String	No	Country code (see: https://chahuo.com/country-code-lookup.html)
realPhoneTemplateId	65	Long	No	Template ID (refer to [Paginated Get Real Device Templates])
androidProp	{"persist.sys.cloud.wifi.mac": "D2:48:83:70:66:0B"}	Object	No	Refer to [Android Modification Properties List]
replacementRealAdiFlag	false	Boolean	No	Whether random ADI template for real device (false-no, true-yes)
excludeRealPhoneTemplateIds	[101,102]	Long[]	No	Exclude template IDs when random
certificate	Refer to [Phone Root Certificate]	String	No	Phone root certificate
wipeData	true	Boolean	No	Clear user data (default true, CBS2.4.4+ support)
wipeSpecificData	["/fonts","/media"]	String[]	No	Effective when wipeData false; specify data to clear
enableCpuCoreConfig	true	Boolean	No	Enable CPU core config (based on Android cpuset for performance stability)

Response Parameters

Parameter Name	Example Value	Type	Description
code	200	Integer	Status code
msg	success	String	Response message
ts	1721739857317	Long	Timestamp
traceId	ewc84g8si0oy	String	Trace ID
data		Object
├─ taskId	12818	Long	Task ID
├─ padCode	AC22030010124	String	Instance code
├─ vmStatus		Integer	Instance online status (0: offline; 1: online)
├─ taskStatus	1	Integer	Task status (-1: task exists; 1: added)

Request Example

{
  "padCodes": ["AC32010250031"],
  "countryCode": "SG",
  "realPhoneTemplateId": 210,
  "androidProp": {
    "persist.sys.cloud.battery.level": "67",
    "persist.sys.cloud.gps.lat": "1.3657",
    "persist.sys.cloud.gps.lon": "103.6464",
    "persist.sys.cloud.imsinum": "525050095718767"
  },
  "replacementRealAdiFlag": true,
  "excludeRealPhoneTemplateIds": [101, 102],
  "certificate": "手机根证书",
  "wipeData": false,
  "wipeSpecificData": ["/fonts", "/media"]
}

Response Example 1

{
  "code": 200,
  "msg": "success",
  "ts": 1732270378320,
  "data": {
    "taskId": 8405,
    "padCode": "AC32010250031",
    "vmStatus": 2,
    "taskStatus": 1
  },
  "traceId": "ewab8qjqbaio"
}

Response Example 2

{
   "code": 500,
   "msg": "Currently not supporting country code: xx",
   "ts": 1753521350163,
   "data": null,
    "traceId": "ewab8qjqbaio"
}

Query One-Key New Device Supported Countries List

API Endpoint

/vcpcloud/api/padApi/country

Request Method

GET

Request Content Type

application/json

Response Parameters

Parameter Name	Example Value	Type	Description
code	200	Integer	Status code
msg	success	String	Response message
ts	1721739857317	Long	Timestamp
traceId	ewc84g8si0oy	String	Trace ID
data		Object[]
├─ code	AD	String	Country code
├─ name	Andorra	String	Country name (English)

Response Example

{
  "code": 200,
  "msg": "success",
  "ts": 1730192434383,
  "traceId": "ewab8qjqbaio",
  "data": [{
    "code": "AD",
    "name": "Andorra"
  }]
}

Device Replacement

API Endpoint

/vcpcloud/api/padApi/replacement

Request Method

POST

Request Content Type

application/json

Request Body Parameters

Parameter Name	Example Value	Type	Required	Description
padCode	AC22030010001	String	Yes	Instance code

Response Parameters

Parameter Name	Example Value	Type	Description
code	200	Integer	Status code
msg	success	String	Response message
ts	1721739857317	Long	Timestamp
data		Object[]
├─ equipmentId	358504	Long	Device ID
├─ padCode	AC32011030092	String	Instance code

Request Example

{
    "padCode": "AC32010030001"
}

Response Example

{
    "msg": "success",
    "code": 200,
    "data": {
        "padCode": "AC32011030092",
        "equipmentId": 358504
    },
    "ts": 1741078432830
}

Get Instance Real-Time Preview Image

Get current screen screenshot for specified instance. Returns URL and expiration; access URL for real-time screenshot. Supports batch.

API Endpoint

/vcpcloud/api/padApi/getLongGenerateUrl

Request Method

POST

Request Content Type

application/json

Request Body Parameters

Parameter Name	Example Value	Type	Required	Description
padCodes	["AC22030010001"]	Array	Yes	Instance list
format	png / jpg	String	No	Image format: png, jpg (default png; png no compression)
height	800	String	No	Scaled height (pixels; default original)
width	1280	String	No	Scaled width (pixels; default original)
quality	60	Integer	No	Image quality (0-100; default 50%; below 60 blurry)

Response Parameters

Parameter Name	Example Value	Type	Description
code	200	Integer	Status code
msg	success	String	Response message
ts	1721739857317	Long	Timestamp
data		Object[]
├─ padCode	AC32011030092	String	Instance code
├─ url	http://xxx.png	String	Access URL
├─ expireAt	1756024767163	Long	URL expiration timestamp
├─ success	true	Boolean	Success generating URL
├─ reason	Instance status abnormal	String	Failure reason (empty on success)

Request Example

{
    "padCodes": [
        "AC11010000031",
        "AC11010000032"
    ],
    "format": "png"
}

Response Example

{
    "code": 200,
    "msg": "success",
    "ts": 1756021167163,
    "data": [
        {
            "padCode": "AC11010000031",
            "url": "http://xxx.png",
            "expireAt": 1756024767163,
            "success": true,
            "reason": ""
        },
        {
            "padCode": "AC11010000032",
            "url": "",
            "expireAt": null,
            "success": false,
            "reason": "实例状态异常"
        }
    ]
}

Update Contacts

fileUniqueId or info required one API Endpoint
/vcpcloud/api/padApi/updateContacts

Request Method

POST

Request Content Type

application/json

Request Body Parameters

Parameter Name	Example Value	Type	Required	Description
padCodes	[]	Array	Yes	Instance list
fileUniqueId	cfca25a2c62b00e065b417491b0cf07ffc	String	No	Contacts file ID
operateType	-1	Integer	No	-1 add, 0 delete, 1 overwrite (default -1)
info		Object[]	No	Contacts info
├─ firstName	tom	String	No	Name
├─ phone	13111111111	String	No	Phone
├─ email	tom@gmail.com	String	No	Email

Response Parameters

Parameter Name	Example Value	Type	Description
code	200	Integer	Status code
msg	success	String	Response message
ts	1721739857317	Long	Timestamp
traceId	ewc84g8si0oy	String	Trace ID
data		Object
├─ taskId	12818	Long	Task ID
├─ padCode	AC22030010124	String	Instance code
├─ taskStatus	1	Integer	Task status (-1: task exists; 1: added)
├─ vmStatus		Integer	Instance online status (0: offline; 1: online)

Request Example

{
  "fileUniqueId": "cfca25a2c62b00e065b417491b0cf07ffc",
  "info": [{
    "firstName": "tom",
    "phone": "13111111111",
    "email": "xxxxx@gmail.com"
  }],
  "padCodes": [
    "AC32010180326"
  ]
}

Response Example

{
  "code": 200,
  "msg": "success",
  "ts": 1756373645105,
  "data": [
    {
      "taskId": 392077,
      "padCode": "ATP250822LBOD8V7",
      "vmStatus": 0,
      "taskStatus": 1
    }
  ],
  "traceId": "ewcs8ow5u328"
}

Instance Set Proxy

API Endpoint

/vcpcloud/api/padApi/setProxy

Request Method

POST

Request Content Type

application/json

Request Body Parameters

Parameter Name	Example Value	Type	Required	Description
account	2222	String	No	Username
password	2222	String	No	Password
ip	47.76.241.5	String	No	IP
port	2222	Integer	No	Port
enable	true	Boolean	Yes	Enable
padCodes		Array	Yes	Instance list
proxyType	vpn	String	No	Supported: proxy, vpn
proxyName	socks5	String	No	Supported: socks5, http-relay (includes http/https)
bypassPackageList		Array	No	Bypass packages
bypassIpList		Array	No	Bypass IPs
bypassDomainList		Array	No	Bypass domains
sUoT	true	Boolean	No	Enable UDP (default false)

Response Parameters

Parameter Name	Example Value	Type	Description
code	200	Integer	Status code
msg	success	String	Response message
ts	1756021167163	Long	Timestamp
traceId	ewc84g8si0oy	String	Trace ID
data		Object
├─ taskId	24	Long	Task ID
├─ padCode	AC22030010001	String	Instance code
├─ vmStatus		Integer	Instance online status (0: offline; 1: online)
├─ taskStatus	1	Integer	Task status (-1: task exists; 1: added)

Request Example

{
 "padCodes": [
  "AC32010140023"
 ],
 "account": "2222",
 "password": "2222",
 "ip": "47.76.241.5",
 "port": 2222,
 "enable": true,
    "bypassPackageList":[],
    "bypassIpList":[],
    "bypassDomainList":[],
    "sUoT":true
}

Response Example

{
    "code": 200,
    "msg": "success",
    "ts": 1756313787216,
    "data": [
        {
            "taskId": 22323879,
            "padCode": "ACN250828ED53YMG",
            "vmStatus": 0,
            "taskStatus": 1
        }
    ],
    "traceId": "ewab8whwonb4"
}

Real-Time Query Installed Apps List

API Endpoint

/vcpcloud/api/padApi/listInstalledApp

Request Method

POST

Request Content Type

application/json

Request Body Parameters

Parameter Name	Example Value	Type	Required	Description
padCodes	AC32010250001	String[]	Yes	Instance codes
appName		String	No	App name

Response Parameters

Parameter Name	Example Value	Type	Description
code	200	Integer	Status code
msg	success	String	Response message
traceId	ewc84g8si0oy	String	Trace ID
ts	1756021167163	Long	Timestamp
data		Object
├─ padCode	AC32010250001	String	Instance code
├─ apps		Object[]	App list
├─ ├─ appName	测试app	String	App name
├─ ├─ packageName	com.xxx.xxx	String	Package name
├─ ├─ versionCode	150600	String	Version code
├─ ├─ versionName	15.6.0	String	Version name
├─ ├─ appState	0	Integer	0-installed, 1-installing, 2-downloading

Request Example

{
 "padCodes": ["AC32010250001"],
 "appName": ""
}

Response Example

{
    "code": 200,
    "msg": "success",
    "ts": 1756313784076,
    "data": [
        {
            "padCode": "ACP250417KYBOAXK",
            "apps": [
                {
                    "appName": "WeChat",
                    "packageName": "com.tencent.mm",
                    "versionCode": "2900",
                    "versionName": "8.0.62",
                    "appState": 0
                }
            ]
        }
    ],
    "traceId": "ewab8qh6vwg1"
}

Set App Keep-Alive

Currently supports Android 13,14,15 only.

API Endpoint

/vcpcloud/api/padApi/setKeepAliveApp

Request Method

POST

Request Content Type

application/json

Request Body Parameters

Parameter Name	Example Value	Type	Required	Description
padCodes	AC32010250001	String[]	No	Instance codes
applyAllInstances	false	Boolean	Yes	Apply to all instances mode
appInfos		Object[]	No
├─ serverName	com.example/com.example.service.TaskService	String	Yes	com.xxx.xxx (package)/com.xxx.xxx.service.DomeService (full service path)

Response Parameters

Parameter Name	Example Value	Type	Description
code	200	Integer	Status code
msg	success	String	Response message
ts	1756021167163	Long	Timestamp
data	null

Request Example

{
 "padCodes": [
  "AC002",
  "AC001"
 ],
 "appInfos": [{
   "serverName": "com.example/com.example.service.TaskService"
  }
 ],
 "applyAllInstances": false
}

Response Example

{
    "code": 200,
    "msg": "success",
    "ts": 1736326542985,
    "data": [{
        "taskId": 10074,
        "padCode": "AC32010250011",
        "errorMsg": null
    }]
}

Upload User Image

API Endpoint

/vcpcloud/api/padApi/addUserRom

Request Method

POST

Request Content Type

application/json

Request Body Parameters

Parameter Name	Example Value	Type	Required	Description
name	CloudROM-13	String	Yes	ROM name
updateLog	更新	String	Yes	Update log
androidVersion	13	String	Yes	Android version
version	v1.0.0	String	Yes	Version
downloadUrl	https://file.vmoscloud.com/userFile/userRom/d281d848eff49adee2dda2475235b80b2.tar	String	Yes	Download URL
packageSize	236978175	String	Yes	Size (bytes)

Response Parameters

Field Name	Example Value	Type	Description
code	200	Integer	Status code
msg	success	String	Response message
ts	1736326542985	Long	Timestamp
data	img-2505287582886572	String	Image ID

Request Example

{
    "name": "CloudROM-13-11",
    "updateLog": "更新日志",
    "androidVersion": "13",
    "version": "v1.0.0",
    "downloadUrl": "https://file.vmoscloud.com/userFile/userRom/d281d848eff49adee2dda2475235b80b2.tar",
    "packageSize": 236978175,
}

Response Example

{
    "msg": "success",
    "code": 200,
    "data": "img-2505287582886572",
    "ts": 1748425758327
}

Set App Hide

(Pending Launch)
Send hide package list to instance; empty list clears hide list. Note: If app not installed, setting ineffective; restart after install.

API Endpoint

vcpcloud/api/padApi/setHideAppList

Request Method

POST

Request Content Type

application/json

Request Body Parameters

Parameter Name	Example Value	Type	Required	Description
padCodes	AC32010250001	String[]	Yes	Instance codes (max 500)
appInfos		Object[]	Yes	Hide app list (0-500; empty clears)
├─ packageName	com.tencent.mm	String	No	Package name (empty or empty array clears)

Response Parameters

Parameter Name	Example Value	Type	Description
code	200	Integer	Status code
msg	success	String	Response message
ts	1756021167163	Long	Timestamp
data	null

Request Example

{
 "padCodes": [
  "AC002",
  "AC001"
 ],
 "appInfos": [{
   "packageName": "com.tencent.mm"
  }]
}

Clear Hide List Example

{
 "padCodes": [
  "AC002",
  "AC001"
 ],
 "appInfos": []
}

Response Example

{
    "code": 200,
    "msg": "success",
    "ts": 1736326542985,
    "data": null
}

Modify Real Device ADI Template

Modify cloud real device ADI template with provided template ID.
Conditions:

Instance created as cloud real device type
Instance Android version matches target ADI version

API Endpoint

/vcpcloud/api/padApi/replaceRealAdiTemplate

Request Method

POST

Request Content Type

application/json

Request Body Parameters

Parameter Name	Example Value	Type	Required	Description
padCodes		String[]	Yes
├─	AC21020010001	String	Yes	Instance code
wipeData	false	Boolean	Yes	Clear data
realPhoneTemplateId	186	Long	Yes	Real device template ID

Response Parameters

Parameter Name	Example Value	Type	Description
code	200	Integer	Status code
msg	success	String	Response message
ts	1756021167163	Long	Timestamp
data		Object[]
├─ taskId	1	Integer	Task ID
├─ padCode	AC21020010001	String	Instance code
├─ vmStatus	1	Integer	Instance online status (0: offline; 1: online)
├─ taskStatus	1	Integer	Task status (-1: task exists; 1: added)

Request Example

{
 "padCodes": ["AC32010250011"],
 "wipeData": true,
 "realPhoneTemplateId": 186
}

Response Example

{
 "code": 200,
 "msg": "success",
 "ts": 1736326542985,
 "data": [{
  "taskId": 10074,
  "padCode": "AC32010250011",
  "errorMsg": null,
   "taskStatus": 1
 }]
}

Error Codes

Error Code	Error Description	Suggestion
110028	Instance does not exist	Contact admin
110064	Some instances do not meet real device upgrade conditions	Check instance type
110099	ADI template does not exist	Check parameters

Async Execute ADB Commands

Async execute commands in one or more cloud instances.

API Endpoint

/vcpcloud/api/padApi/asyncCmd

Request Method

POST

Request Content Type

application/json

Request Body Parameters

Parameter Name	Example Value	Type	Required	Description
padCodes		String[]	Yes
├─	AC22020020793	String	Yes	Instance code
scriptContent	cd /root;ls	String	Yes	ADB commands (multiple separated by 😉

Response Parameters

Parameter Name	Example Value	Type	Description
code	200	Integer	Status code
msg	success	String	Response message
traceId	ewc84g8si0oy	String	Trace ID
ts	1756021167163	Long	Timestamp
data		Object[]
├─ taskId	1	Integer	Task ID
├─ padCode	AC22020020793	String	Instance code
├─ vmStatus	1	Integer	Instance online status (0: offline; 1: online)

Request Example

{
    "padCodes": [
        "AC22020020793"
    ],
    "scriptContent": "cd /root;ls"
}

Response Example

{
 "code": 200,
 "msg": "success",
 "ts": 1717570297639,
  "traceId": "ewab8whwonb4",
  "data": [
  {
   "taskId": 14,
   "padCode": "AC22030010001",
   "vmStatus": 1
  },
  {
   "taskId": 15,
   "padCode": "AC22030010002",
   "vmStatus": 0
  }
 ]
}

Error Codes

Error Code	Error Description	Suggestion
110003	ADB command failed	Contact admin
110012	Command timeout	Retry later

Switch Root Permissions

Switch root permissions in one or more cloud instances. For single app root, specify package name (cloud real device: not recommended global root due to detection risk).

API Endpoint

/vcpcloud/api/padApi/switchRoot

Request Method

POST

Request Content Type

application/json

Request Body Parameters

Parameter Name	Example Value	Type	Required	Description
padCodes		String[]	Yes
├─	AC22020020793	String	Yes	Instance code
globalRoot	false	Boolean	No	Global root (default no)
packageName	com.example	String	No	Package name (required for non-global; multiple comma separated)
rootStatus		Integer	Yes	Root status: 0-off, 1-on

Response Parameters

Parameter Name	Example Value	Type	Description
code	200	Integer	Status code
msg	success	String	Response message
ts	1756021167163	Long	Timestamp
data		Object[]
├─ taskId	1	Integer	Task ID
├─ padCode	AC22020020793	String	Instance code
├─ vmStatus	1	Integer	Instance online status (0: offline; 1: online)

Request Example

{
  "padCodes": [
    "AC32010250002"
  ],
  "globalRoot": false,
  "packageName": "com.android.ftpeasys",
  "rootStatus": 0
}

Response Example

{
 "code": 200,
 "msg": "success",
 "ts": 1717570297639,
 "data": [
  {
   "taskId": 14,
   "padCode": "AC32010250002",
   "vmStatus": 1
  }
 ]
}

Error Codes

Error Code	Error Description	Suggestion
110003	ADB command failed	Contact admin
110089	Single root package name empty	Provide package name for single app root

Local Screenshot

Instance screenshot.

API Endpoint

/vcpcloud/api/padApi/screenshot

Request Method

POST

Request Content Type

application/json

Request Body Parameters

Parameter Name	Example Value	Type	Required	Description
padCodes		String[]	Yes
├─	AC21020010231	String	Yes	Instance code
rotation	0	Integer	Yes	Screenshot orientation: 0-default, 1-rotate to portrait
broadcast	false	Boolean	No	Broadcast event (default false)
definition		Integer	No	Clarity 0-100
resolutionHeight		Integer	No	Height >1
resolutionWidth		Integer	No	Width >1

Response Parameters

Parameter Name	Example Value	Type	Required	Description
code	200	Integer	Yes	Status code
msg	success	String	Yes	Response message
ts	1756021167163	Long	Yes	Timestamp
data		Object[]	No
├─ taskId	1	Integer	No	Task ID
├─ padCode	AC21020010231	String	No	Instance code
├─ vmStatus	1	Integer	Yes	Instance online status (0: offline; 1: online)

Request Example

{
 "padCodes": [
  "AC21020010231"
 ],
 "rotation": 0,
 "broadcast": false,
    "definition": 50,
    "resolutionHeight": 1920,
    "resolutionWidth": 1080
}

Response Example

{
 "code": 200,
 "msg": "success",
 "ts": 1717570337023,
 "data": [
  {
   "taskId": 16,
   "padCode": "AC22030010001",
   "vmStatus": 1
  },
  {
   "taskId": 17,
   "padCode": "AC22030010002",
   "vmStatus": 0
  }
 ]
}

Error Codes

Error Code	Error Description	Suggestion
110001	Screenshot failed	Retry
110004	Restart failed	Restart later
110028	Instance not exist	Check instance

Generate Preview Image

Get preview image for specified instance.

API Endpoint

/vcpcloud/api/padApi/generatePreview

Request Method

POST

Request Content Type

application/json

Request Body Parameters

Parameter Name	Example Value	Type	Required	Description
padCodes		String[]	Yes
├─	AC11010000031	String	Yes	Instance code
rotation	0	Integer	Yes	Screenshot orientation: 0-default, 1-rotate to portrait
broadcast	false	Boolean	No	Broadcast event (default false)

Response Parameters

Parameter Name	Example Value	Type	Description
code	200	Integer	Status code
msg	success	String	Response message
ts	1756021167163	Long	Timestamp
data		Object[]
├─ padCode	AC11010000031	String	Instance code
├─ url	http://xxx.armcloud.png	String	Access URL
├─ expireAt	1756024767163	Long	URL expiration
├─ success	true	Boolean	Success
├─ reason	Instance status abnormal	String	Failure reason

Request Example

{
    "padCodes": [
        "AC11010000031",
        "AC11010000032"
    ],
    "format": "png"
}

Response Example

{
    "code": 200,
    "msg": "success",
    "ts": 1756021167163,
    "data": [
        {
            "padCode": "AC11010000031",
            "url": "http://xxx.armcloud.png",
            "expireAt": 1756024767163,
            "success": true,
            "reason": ""
        },
        {
            "padCode": "AC11010000032",
            "url": "",
            "expireAt": null,
            "success": false,
            "reason": "实例状态异常"
        }
    ]
}

Upgrade Image

Batch instance image upgrade.

API Endpoint

/vcpcloud/api/padApi/upgradeImage

Request Method

POST

Request Content Type

application/json

Request Body Parameters

Parameter Name	Example Value	Type	Required	Description
padCodes		String[]	Yes
├─	AC22030010182	String	Yes	Instance code
imageId	mg-24061124017	String	Yes	Image ID
wipeData	false	Boolean	Yes	Clear data partition: true-yes, false-no
enableCpuCoreConfig	true	Boolean	No	Enable CPU core config

Response Parameters

Parameter Name	Example Value	Type	Description
code	200	Integer	Status code
msg	success	String	Response message
ts	1756021167163	Long	Timestamp
traceId	ewc84g8si0oy	String	Trace ID
data		Object[]
├─ padCode	AC22030010182	String	Instance code
├─ taskId	1	Integer	Task ID
├─ errorMsg	“”	String	Error message

Request Example

{
    "padCodes": [
        "AC22030010182"
    ],
    "wipeData": false,
    "imageId": "mg-24061124017"
}

Response Example

{
 "code": 200,
  "traceId": "ewab8whwonb4",
  "msg": "success",
 "ts": 1718594881432,
 "data": [
  {
   "taskId": 63,
   "padCode": "AC22030010182",
   "errorMsg": null
  }
 ]
}

Error Codes

Error Code	Error Description	Suggestion
110041	Image does not exist	Check image ID
110037	Upgrade command failed	Instance status issue
110038	Upgrade execution failed	Instance status issue

Upgrade Real Device Image

Batch real device image upgrade.

API Endpoint

/vcpcloud/api/padApi/virtualRealSwitch

Request Method

POST

Request Content Type

application/json

Request Body Parameters

Parameter Name	Example Value	Type	Required	Description
padCodes		String[]	Yes
├─	AC22030010182	String	Yes	Instance code
imageId	mg-24061124017	String	Yes	Image ID
wipeData	false	Boolean	Yes	Clear data: true-yes, false-no
realPhoneTemplateId	178	Integer	No	Real device template ID (required for real)
upgradeImageConvertType	virtual	String	Yes	Convert type: virtual / real
screenLayoutId	14	Integer	No	Screen layout ID (required for virtual)
certificate	Refer to [Phone Root Certificate]	String	No	Custom root certificate
deviceAndroidProps	{"persist.sys.cloud.wifi.mac": "D2:48:83:70:66:0B"}	Object	No	Android props (CBS <2.4.4 not support)
enableCpuCoreConfig	true	Boolean	No	Enable CPU core config

Response Parameters

Parameter Name	Example Value	Type	Description
code	200	Integer	Status code
msg	success	String	Response message
ts	1756021167163	Long	Timestamp
traceId	ewc84g8si0oy	String	Trace ID
data		Object[]
├─ padCode	AC22030010182	String	Instance code
├─ taskId	1	Integer	Task ID
├─ errorMsg	“”	String	Error message

Request Example

{
    "padCodes": [
        "AC32010210023"
    ],
        "imageId": "img-24112653977",
        "wipeData": true,
        "realPhoneTemplateId": 178,
        "upgradeImageConvertType": "virtual",
        "screenLayoutId": 14
}

Response Example

{
 "code": 200,
 "msg": "success",
 "ts": 1718594881432,
 "traceId": "ewab8whwonb4",
    "data": [
  {
   "taskId": 63,
   "padCode": "AC22030010182",
   "errorMsg": null
  }
 ]
}

Error Codes

Error Code	Error Description	Suggestion
110041	Image does not exist	Check image ID
110037	Upgrade command failed	Instance status issue
110038	Upgrade execution failed	Instance status issue
110064	Some instances do not meet real device conditions	Check instances

Paginated Get Real Device Templates

Paginated retrieval of real device templates.

API Endpoint

/vcpcloud/api/padApi/templateList

Request Method

POST

Request Content Type

application/json

Request Body Parameters

Parameter Name	Example Value	Type	Required	Description
pageIndex	1	Integer	No	Page number (default 1)
pageSize	10	Integer	No	Records per page (default 10, range 1-100)
androidImageVersion	14	String	No	Android image version

Response Parameters

Parameter Name	Example Value	Type	Description
code	200	Integer	Status code
msg	success	String	Response message
ts	1756021167163	Long	Timestamp
traceId	ewc84g8si0oy	String	Trace ID
data		Object[]	Response data list
├─ id	178	Long	Account ID
├─ brand	google	String	Brand
├─ model	Pixel 7 Pro(12G)	String	Model
├─ fingerprintMd5	f5da7b97678ac19309f0cf0203e072d7	String	Android MD5 (ro.build.fingerprint)
├─ fingerprint	google/cheetah/cheetah:13/TQ3A.230901.001/10750268:user/release-keys	String	Android ro.build.fingerprint
├─ resourceSpecificationCode	m2-3	String	Specification code
├─ screenLayoutCode	realdevice_1440x3120x560	String	Screen layout code
├─ adiTemplateDownloadUrl	https://example.com/file.zip	String	ADI template file download path
├─ adiTemplatePwd	123456	String	ADI template file password
├─ propertyJson	{"test": "testa"}	JSON	Instance properties
├─ androidImageVersion	13	Integer	Android image version
├─ deleteFlag	0	Integer	Deleted (1: yes; 0: no)
├─ createBy	admin	String	Creator
├─ createTime	2024-08-28 12:00:00	Timestamp	Create time
├─ updateBy	admin	String	Updater
├─ updateTime	2024-08-28 12:30:00	Timestamp	Update time
├─ deviceName	Pixel Pro	String	Device name (alias/display)
├─ isOfficial	1	Integer	Official (0: test; 1: official)
├─ status	1	Integer	Enabled (0: disabled; 1: enabled)
├─ adiTemplateVersion	v1.0.2	String	ADI template version
├─ modelCode	cheetah	String	Model code
├─ isPublic	1	Integer	Template type (1: public; 0: private)
├─ aospVersion	13.0.1	String	AOSP version
├─ testCasesDownloadUrl	https://example.com/cases.zip	String	Test cases file download path

Request Example

{
    "pageIndex": 1,
    "pageSize": 10
}

Response Example

{
    "code": 200,
    "msg": "success",
    "ts": 1756313820061,
    "data": [
        {
            "id": 202,
            "createTime": "2025-03-12T02:29:43.000+00:00",
            "createBy": "",
            "updateTime": "2025-04-29T09:44:28.000+00:00",
            "updateBy": "",
            "brand": "HONOR(FIX)",
            "model": "ELZ-AN10(8G)",
            "fingerprint": "HONOR/ELZ-AN10/HNELZ:14/HONORELZ-AN10/8.0.0.185CHNC00E185R4P6:user/release-keys",
            "fingerprintMd5": "9bf2de4b6aa70466a6f76f66539c4613",
            "resourceSpecificationCode": "m2-4",
            "screenLayoutCode": "realdevice_1344x2772x476",
            "adiTemplateDownloadUrl": "https://oss-hk.armcloud.net/adi/35fdc068d6fdc32a691554989008160b_fix2.zip",
            "adiTemplatePwd": "XMDoxJgoKIZKoWbWlnmY",
            "propertyJSON": "{}",
            "androidImageVersion": 14,
            "deleteFlag": false,
            "deviceName": "ELZ-AN10(8G)",
            "isOfficial": 1,
            "status": 1,
            "adiTemplateVersion": null,
            "modelCode": null,
            "isPublic": 1,
            "testCasesDownloadUrl": null,
            "aospVersion": "android14"
        }
    ],
    "traceId": "ewabantnnwn4"
}

Batch Get Instance Device Model Information

(Pending Launch)
Batch get device model information for corresponding instances based on instance codes.

API Endpoint

/vcpcloud/api/padApi/modelInfo

Request Method

POST

Request Content Type

application/json

Request Body Parameters

Parameter Name	Example Value	Type	Required	Description
padCodes		String[]	Yes
├─	AC22030010182	String	Yes	Instance code

Response Parameters

Parameter Name	Example Value	Type	Description
code	200	Integer	Status code
msg	success	String	Response message
traceId	ewbssur1jbwg	String	Trace ID
ts	1756021167163	Long	Timestamp
data		Object[]
├─ padCode	AC22030010182	String	Instance code
├─ imei	524803173613682	String	IMEI
├─ serialno	01NM5ON34M4O	String	Serial number
├─ wifimac	04:3a:6c:e5:e9:8d:62:d6:4a	String	Wi-Fi MAC address
├─ androidid	aa6bcedf1426546c	String	Android instance unique ID
├─ model	Mi 10 Pro	String	Model
├─ brand	Xiaomi	String	Brand
├─ manufacturer	Xiaomi	String	Manufacturer
├─ isRoot	1	String	Rooted (1: yes)
├─ width	720	Integer	Cloud phone width (max 1080)
├─ height	1280	Integer	Cloud phone height (max 1920)
├─ memoryLimit	1024	Integer	Memory limit
├─ bluetoothaddr	3A:1F:4B:9C:2D:8E	String	Bluetooth address
├─ phonenum	1112341234	String	Phone number
├─ romVersion	android13	String	Android version
├─ dataSize	2367381504	Integer	Storage size (bytes)
├─ dataSizeAvailable	365830144	Integer	Available storage (bytes)
├─ dataSizeUsed	2001551360	Integer	Used storage (bytes)
├─ romVersion	android14	String	ROM version

Request Example

{
    "padCodes": [
        "AC22030010182"
    ]
}

Response Example

{
    "code": 200,
    "msg": "success",
    "ts": 1752845766596,
    "data": [
        {
            "padCode": "ACN250718J6ZLUYS",
            "imei": "237150320344334",
            "serialno": null,
            "wifimac": "44:5a:56:fb:6a:ec",
            "androidid": "ecb978a3cafff13",
            "model": "SM-A057F",
            "brand": "samsung",
            "manufacturer": "samsung",
            "isRoot": null,
            "width": 1080,
            "height": 2400,
            "memoryLimit": null,
            "bluetoothaddr": null,
            "phonenum": null,
            "dataSize": null,
            "dataSizeAvailable": null,
            "dataSizeUsed": null,
            "romVersion": "android14"
        }
    ],
    "traceId": "esb357am18n4"
}

Set Instance Bandwidth

(Pending Launch)
Set instance bandwidth based on instance code.

API Endpoint

/vcpcloud/api/padApi/setSpeed

Request Method

POST

Request Content Type

application/json

Request Body Parameters

Parameter Name	Example Value	Type	Required	Description
padCodes		String[]	Yes
├─	AC22030010124	String	Yes	Instance code
upBandwidth	10.00	float	Yes	Upload bandwidth Mbps (0: unlimited; -1: block internet)
downBandwidth	10.00	float	Yes	Download bandwidth Mbps (0: unlimited; -1: block internet)

Response Parameters

Parameter Name	Example Value	Type	Description
code	200	Integer	Status code
msg	success	String	Response message
ts	1721739857317	Long	Timestamp
traceId	ewbssur1jbwg	String	Trace ID
data		Object[]
├─ taskId	679	Integer	Task ID
├─ padCode	AC32010140011	String	Instance code
├─ vmStatus	1	Integer	Instance online status (0: offline; 1: online)
├─ taskStatus	1	Integer	Task status (-1: task exists; 1: added)

Request Example

{
 "padCodes": [
  "AC32010140011"
 ],
 "upBandwidth": 10.00,
 "downBandwidth": 10.00
}

Response Example

{
 "code": 200,
 "msg": "success",
 "traceId": "ewab8qjqbaio",
 "ts": 1721640654237,
 "data": [
  {
   "taskId": 679,
   "padCode": "AC32010140011",
   "vmStatus": 1,
   "taskStatus": 1
  }
 ]
}

Enable/Disable ADB

Enable or disable ADB for instance based on instance code.

API Endpoint

/vcpcloud/api/padApi/openOnlineAdb

Request Method

POST

Request Content Type

application/json

Request Body Parameters

Parameter Name	Example Value	Type	Required	Description
padCodes		String[]	Yes	Instance list (1-200 instances)
├─	AC32010250032	String	Yes	Instance code
openStatus	1	Integer	Yes	ADB status (1: enable; 0 or omit: disable)

Response Parameters

Parameter Name	Example Value	Type	Description
code	200	Integer	Status code
msg	success	String	Response message
ts	1721739857317	Long	Timestamp
data		Object[]
├─ taskId	16147	Integer	Task ID
├─ padCode	AC32010250032	String	Instance code
├─ taskStatus	3	Integer	Task status (-1: all failed; -2: partial failed; -3: canceled; -4: timeout; -5: abnormal; 1: pending; 2: executing; 3: completed)
├─ taskResult	success	String	Task result

Request Example

{
    "padCodes":[
        "AC32010250032"
    ],
    "openStatus": 1
}

Response Example

{
    "code": 200,
    "msg": "success",
    "ts": 1736920929306,
    "data": [
        {
        "taskId": 16147,
        "padCode": "AC32010250032",
        "taskStatus": 3,
        "taskResult": "success"
        }
    ]
}

Get ADB Connection Information

Get ADB connection information based on instance code. If response data (key, adb) incomplete, call [Enable/Disable ADB] to enable ADB first.

API Endpoint

/vcpcloud/api/padApi/adb

Request Method

POST

Request Content Type

application/json

Request Body Parameters

Parameter Name	Example Value	Type	Required	Description
padCode	AC32010250032	String	Yes	Instance code
enable	true	Boolean	Yes	ADB status: true-enable, false-disable

Response Parameters

Parameter Name	Example Value	Type	Description
code	200	Integer	Status code
msg	success	String	Response message
traceId	ewbssur1jbwg	String	Trace ID
ts	1736922808949	Long	Timestamp
data		Object[]
├─ padCode	AC32010250032	String	Instance code
├─ command	ssh -oHostKeyAlgorithms=+ssh-rsa 10.255.3.2_001_1736922765389@156.59.80.166 -p 1824 -L 8572:adb-proxy:53728 -Nf	String	SSH connection command
├─ expireTime	2025-01-16 14:32:00	String	ADB link expiration
├─ enable	true	Boolean	ADB status: true-enable, false-disable
├─ key	3CXr3FJZ6gbnGuJctDOpP9M6X6Rl786xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx==	String	Connection key
├─ adb	adb connect localhost:8577	String	ADB connection info

Request Example

{
    "padCode": "AC32010250032",
    "enable": true
}

Response Example

{
    "code": 200,
    "msg": "success",
    "traceId": "ewab8qjqbaio",
    "ts": 1736922808949,
    "data": {
        "padCode": "AC32010250032",
        "command": "ssh -oHostKeyAlgorithms=+ssh-rsa 10.255.3.2_001_1736922765389@156.59.80.166 -p 1824 -L 8572:adb-proxy:53728 -Nf",
        "expireTime": "2025-01-16 14:32:00",
        "enable": true,
        "key": "3CXr3FJZ6gbnGuJctDOpP9M6X6Rl786xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx==",
        "adb": "adb connect localhost:8577"
    }
}

Batch Get ADB Connection Information

(Pending Launch)
Batch get or disable ADB connection information based on instance code list. If enable success but connection info incomplete, call [Enable/Disable ADB] to re-enable first. Max 10 instances per call.

API Endpoint

/vcpcloud/api/padApi/batch/adb

Request Method

POST

Request Content Type

application/json

Request Body Parameters

Parameter Name	Example Value	Type	Required	Description
padCodes	["AC32010250032","AC32010250033"]	String[]	Yes	Instance code list (max 10)
enable	true	Boolean	Yes	Enable ADB: true-enable and return info, false-disable

Response Parameters

Parameter Name	Example Value	Type	Description
code	200	Integer	Status code
msg	success	String	Response message
traceId	ewbssur1jbwg	String	Trace ID
ts	1736922808949	Long	Timestamp
data		Object
├─ successList		Object[]	Success list
│ ├─ padCode	AC32010250032	String	Instance code
│ ├─ command	ssh -oHostKeyAlgorithms=+ssh-rsa 10.255.3.2_001_1736922765389@156.59.80.166 -p 1824 -L 8572:adb-proxy:53728 -Nf	String	SSH command
│ ├─ expireTime	2025-01-16 14:32:00	String	ADB expiration
│ ├─ enable	true	Boolean	ADB status
│ ├─ key	3CXr3FJZ6gbnGuJctDOpP9M6X6Rl786xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx==	String	Connection key
│ ├─ adb	adb connect localhost:8577	String	ADB connection
├─ failedList		Object[]	Failure list
│ ├─ padCode	AC32010250034	String	Instance code
│ ├─ errorMsg	Instance not running	String	Failure reason
│ ├─ errorCode	PAD_NOT_RUNNING	String	Error code

Request Example

{
    "padCodes": [
        "AC32010250032",
        "AC32010250033"
    ],
    "enable": true
}

Response Example

{
    "code": 200,
    "msg": "success",
    "traceId": "ewbssur1jbwg",
    "ts": 1736922808949,
    "data": {
        "successList": [
            {
                "padCode": "AC32010250032",
                "command": "ssh -oHostKeyAlgorithms=+ssh-rsa 10.255.3.2_001_1736922765389@156.59.80.166 -p 1824 -L 8572:adb-proxy:53728 -Nf",
                "expireTime": "2025-01-16 14:32:00",
                "enable": true,
                "key": "3CXr3FJZ6gbnGuJctDOpP9M6X6Rl786xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx==",
                "adb": "adb connect localhost:8577"
            }
        ],
        "failedList": [
            {
                "padCode": "AC32010250034",
                "errorMsg": "实例未运行",
                "errorCode": "PAD_NOT_RUNNING"
            }
        ]
    }
}

Transfer Cloud Phone

Transfer specified cloud phone instances to another account (via the recipient account's email).

Interface Address

/vcpcloud/api/padApi/confirmTransfer

Request Method

POST

Request Content-Type

application/json

Request Body Parameters

Parameter Name	Example Value	Parameter Type	Required	Description
padCodes	["ACXXXXXXXXX"]	String[]	Yes	List of instance codes to transfer
makeOverMobilePhone	"XXXX.gmail.com"	String	Yes	Recipient account email

Response Parameters

Parameter Name	Example Value	Parameter Type	Description
code	200	Integer	Status code
msg	success	String	Response message
ts	1731055053049	Long	Timestamp
data	true	Boolean	Whether the transfer was successful (true/false)

Request Example

{
  "padCodes": [
    "ACXXXXXXXXX"
  ],
  "makeOverMobilePhone": "XXXX.gmail.com"
}

Response Example

{
  "msg": "success",
  "code": 200,
  "data": true,
  "ts": 1731055053049
}

Simulate Touch

Simulate touch events (down, up, move) in instance via XY coordinates.

Exception check: Repeated requests within 2s return error "Do not operate frequently".

API Endpoint

/vcpcloud/api/padApi/simulateTouch

Request Method

POST

Request Content Type

application/json

Request Body Parameters

Parameter Name	Example Value	Type	Description
padCodes	2200	String[]	Instances to trigger touch
width	120	Integer	Container width
height	120	Integer	Container height
pointCount	1	Integer	Multi-touch (1-10 fingers; default 1)
positions	[{"actionType":0,"x":100,"y":100,"nextPositionWaitTime":20}]	Object[]	Touch coordinate groups
├─ actionType	1	Integer	Action type (0: down; 1: up; 2: move)
├─ x	100	float	X coordinate
├─ y	100	float	Y coordinate
├─ nextPositionWaitTime	100	Integer	Wait time (ms) before next group
├─ swipe	-1	float	Swipe distance (-1: down; 1: up)
├─ touchType	gestureSwipe	String	gestureSwipe-swipe, gesture-touch, keystroke-key (default down+up)
├─ keyCode	1	Integer	Key code
├─ pressure	0.5	float	Touch pressure
├─ size	0.5	float	Touch area ratio

Response Parameters

Parameter Name	Example Value	Type	Description
code	200	Integer	Status code
msg	success	String	Response message
ts	1736922808949	Long	Timestamp
traceId	ewbssur1jbwg	String	Trace ID
data		Object[]
├─ padCode	AC32032	String	Instance code
├─ taskId	10004759	Long	Task ID
├─ vmStatus	0	String	Instance online status
├─ taskStatus	1	Integer	Task status (-1: task exists; 1: added)

Request Example

{
  "padCodes": [
    "实例编号"
  ],
  "width": 1080,
  "height": 1920,
  "pointCount":1,
  "positions": [
    {
      "actionType": 0,
      "x": 100,
      "y": 100,
      "nextPositionWaitTime": 20,
      "swipe":-1,
      "touchType":"gestureSwipe",
      "keyCode":1,
        "pressure":0.5,
        "size":0.5
    },
    {
      "actionType": 2,
      "x": 110,
      "y": 110,
      "nextPositionWaitTime": 22
    },
    {
      "actionType": 2,
      "x": 120,
      "y": 120,
      "nextPositionWaitTime": 23
    },
    {
      "actionType": 1,
      "x": 120,
      "y": 120
    }
  ]
}

Response Example

{
  "code": 200,
  "msg": "success",
  "ts": 1743676563784,
  "traceId": "ewab8qjqbaio",
    "data": [
    {
      "taskId": 100059,
      "padCode": "ACP00001",
      "vmStatus": 0,
      "taskStatus": 1
    },
    {
      "taskId": 100060,
      "padCode": "ACP00001",
      "vmStatus": 0,
      "taskStatus": 1
    }
  ]
}

Instance Operation Task Details

Query detailed execution results for specified instance operation task.

API Endpoint

/vcpcloud/api/padApi/padTaskDetail

Request Method

POST

Request Content Type

application/json

Request Query Parameters

Parameter Name	Example Value	Type	Required	Description
taskIds		Integer[]	Yes
├─ taskId	1	Integer	Yes	Task ID

Response Parameters

Parameter Name	Example Value	Type	Description
code	200	Integer	Status code
msg	success	String	Response message
ts	1756021167163	Long	Timestamp
traceId	ewbssur1jbwg	String	Trace ID
data		Object[]	Sub-task details
├─ taskId	1	Integer	Sub-task ID
├─ padCode	VP22020020793	String	Instance identifier
├─ taskStatus	2	String	Task status (-1: all failed; -2: partial failed; -3: canceled; -4: timeout; 1: pending; 2: executing; 3: completed; 9: queued)
├─ endTime	1713429401000	Long	Sub-task end timestamp
├─ taskContent	“”	String	Task content
├─ taskResult	“”	String	Task result
├─ errorMsg	“”	String	Error message

Request Example

{
 "taskIds":[1,2]
}

Response Example

{
    "code": 200,
    "msg": "success",
    "ts": 1756313781081,
    "data": [
        {
            "taskId": 22323794,
            "padCode": "ACN250828DYJE95Z",
            "taskStatus": 2,
            "endTime": null,
            "taskContent": null,
            "taskResult": null,
            "errorMsg": null
        }
    ],
    "traceId": "ewab8kpxb7k0"
}

Get Instance Script Execution Result

Get script execution result for instance via script task ID.

API Endpoint

/vcpcloud/api/padApi/executeScriptInfo

Request Method

POST

Request Content Type

application/json

Request Body Parameters

Parameter Name	Example Value	Type	Required	Description
taskIds		Integer[]	Yes	Array length 1-100
├─	1	Integer	No	Task ID

Response Parameters

Parameter Name	Example Value	Type	Description
code	200	Integer	Status code
msg	success	String	Response message
traceId	ewc84g8si0oy	String	Trace ID
ts	1756021167163	Long	Timestamp
data		Object[]
├─ taskId	1	Integer	Task ID
├─ padCode	AC22020020793	String	Instance code
├─ taskStatus	3	Integer	Task status (-1: all failed; -2: partial failed; -3: canceled; -4: timeout; 1: pending; 2: executing; 3: completed)
├─ endTime	1756021166163	Long	Task end time
├─ taskContent	Success	String	Task content
├─ taskResult	Success	String	Task result
├─ errorMsg	Instance does not exist	String	Failure reason

Request Example

{
 "taskIds": [1]
}

Response Example

{
    "code": 200,
    "msg": "success",
    "ts": 1752214432301,
    "data": [
        {
            "taskId": 49884,
            "padCode": "ATP250707FNSVRMC",
            "taskStatus": 3,
            "endTime": 1752214271000,
            "taskContent": null,
            "taskResult": null,
            "errorMsg": "调用Adb命令成功"
        }
    ],
    "traceId": "erl0i57h6v40"
}

Get Instance Screenshot Result

(Pending Launch)
Get instance screenshot result via screenshot task ID.

API Endpoint

/vcpcloud/api/padApi/screenshotInfo

Request Method

POST

Request Content Type

application/json

Request Body Parameters

Parameter Name	Example Value	Type	Required	Description
taskIds		Integer[]	Yes
├─	1	Integer	No	Task ID

Response Parameters

Parameter Name	Example Value	Type	Description
code	200	Integer	Status code
msg	success	String	Response message
traceId	ewbssur1jbwg	String	Trace ID
ts	1756021167163	Long	Timestamp
data		Object[]	Task details
├─ taskId	1	Integer	Task ID
├─ taskStatus	3	Integer	Task status (-1: all failed; -2: partial failed; -3: canceled; -4: timeout; 1: pending; 2: executing; 3: completed)
├─ padCode	AC22020020793	String	Instance code
├─ taskContent	Success	String	Task content
├─ taskResult	Success	String	Task result
├─ endTime	1756121167163	String	Task end time

Request Example

{
 "taskIds": [1]
}

Response Example

{
 "code": 200,
 "msg": "success",
  "traceId": "ewab8qjqbaio",
  "ts":1713773577581,
 "data":[
    {
    "taskId": 1,
    "taskStatus": 3,
    "padCode": "AC22020020793",
    "taskContent": "Success",
    "taskResult": "Success",
    "endTime": 1756121167163
    }
   ]
}

Instance Restart/Reset Execution Result

(Pending Launch)
Get instance restart/reset execution result via task ID.

API Endpoint

/vcpcloud/api/padApi/padExecuteTaskInfo

Request Method

POST

Request Content Type

application/json

Request Body Parameters

Parameter Name	Example Value	Type	Required	Description
taskIds		Integer[]	Yes
├─	1	Integer	Yes	Task ID

Response Parameters

Parameter Name	Example Value	Type	Description
code	200	Integer	Status code
msg	success	String	Response message
traceId	ewbssur1jbwg	String	Trace ID
ts	1756021167163	Long	Timestamp
data		Object[]
├─ taskId	1	Integer	Task ID
├─ padCode	AC21020010001	String	Instance code
├─ taskStatus	3	Integer	Task status (-1: all failed; -2: partial failed; -3: canceled; -4: timeout; 1: pending; 2: executing; 3: completed)
├─ endTime	1756021166163	Long	Task end time
├─ taskContent	“”	String	Task content
├─ taskResult	Success	String	Task result

Request Example

{
    "taskIds": [1]
}

Response Example

{
    "code": 200,
    "msg": "success",
    "traceId": "ewab8qjqbaio",
    "ts": 1756021167163
    "data":[
        {
            "taskId": 1,
            "padCode": "AC22030022911",
            "taskStatus": 3,
            "endTime": 1756021166163,
            "taskContent": null,
            "taskResult": "Success"
        }
    ]
}

Instance List Information

Paginated get instance list information based on query conditions.

API Endpoint

/vcpcloud/api/padApi/infos

Request Method

POST

Request Content Type

application/json

Request Body Parameters

Parameter Name	Example Value	Type	Required	Description
page	1	Integer	Yes	Page number
rows	10	Integer	Yes	Records per page
padType	real	String	No	Instance type (virtual: virtual; real: real)
padCodes		String[]	No
├─	AC22010020062	String	Yes	Instance code

Response Parameters

Parameter Name	Example Value	Type	Description
code	200	Integer
msg	success	String
ts	1713773577581	Long
data		Object
├─ page	1	Integer	Current page
├─ rows	10	Integer	Records per page
├─ size	1	Integer	Current page count
├─ total	1	Integer	Total records
├─ totalPage	1	Integer	Total pages
├─ pageData		object[]	List
├─ ├─ padCode	VP21020010391	String	Instance code
├─ ├─ padGrade	q1-2	String	Instance openings
├─ ├─ padStatus	10	String	Instance status
├─ ├─ idcCode	d3c1f580c41525e514330a85dfdecda8	String	Data center code
├─ ├─ deviceIp	192.168.0.0	String	Cloud machine IP
├─ ├─ padIp	192.168.0.0	String	Instance IP
├─ ├─ apps		String[]	Installed apps
├─ ├─ ├─	armcloud001	String	Installed app

Request Example

{
"page": 1,
"rows": 10,
"padCodes": [
"AC21020010391"
]
}

Response Example

{
"code": 200,
"msg": "success",
"ts":1713773577581,
"data": {
"page": 1,
"rows": 1,
"size": 1,
"total": 1,
"totalPage": 1,
"pageData": [
{
{
"padCode": "AC21020010391",
"padGrade": "q2-4",
"padStatus": 10,
"idcCode": "8e61ad284bc105b877611e6fef7bdd17",
"deviceIp": "172.31.2.34",
"padIp": "10.255.1.19",
"apps": [
"armcloud001"
]
}
]
}
}

Import Call Logs

This interface imports call log data into cloud phone. During import, it automatically detects saved contacts and displays corresponding names in call logs for quick identification.

API Endpoint

/vcpcloud/api/padApi/addPhoneRecord

Request Method

POST

Request Content Type

application/json

Request Body Parameters

Parameter Name	Example Value	Type	Required	Description
padCodes	ACP2505060777	String[]	Yes	Instances to edit call logs
callRecords	[{"number":"18009781201","inputType":1,"duration":30,"timeString":"2025-05-06 14:00:09"}]	Object[]	Yes	Call logs
├─ number	13900000000	String	Yes	Phone number
├─ inputType	1	int	Yes	Call type (1: outgoing; 2: incoming; 3: missed)
├─ duration	60	int	Yes	Duration (seconds; 0 for missed)
├─ timeString	2025-05-08 12:30:00	String	No	Call time

Response Parameters

Parameter Name	Example Value	Type	Description
code	200	Integer	Status code
msg	success	String	Response message
ts	1736922808949	Long	Timestamp
data		Object[]
├─ padCode	AC32032	String	Instance code
├─ taskId	10004759	Long	Task ID
├─ vmStatus	0	String	Online status

Request Example

{
  "padCodes": [
     "实例编号"
  ],
  "callRecords": [
    {
      "number": "18009781201",
      "inputType": 1,
      "duration": 30,
      "timeString": "2025-05-06 14:00:09"
    },
    {
      "number": "18009781202",
      "inputType": 2,
      "duration": 60,
      "timeString": "2025-05-07 14:00:09"
    },
    {
      "number": "18009781203",
      "inputType": 3,
      "duration": 0
    }
  ]
}

Response Example

{
  "code": 200,
  "msg": "success",
  "ts": 1743676563784,
  "data": [
    {
      "taskId": 100059,
      "padCode": "ACP00001",
      "vmStatus": 0
    },
    {
      "taskId": 100060,
      "padCode": "ACP00001",
      "vmStatus": 0
    }
  ]
}

Cloud Phone Text Input

Focus input box in cloud phone first, call this interface with text to display at specified position.

API Endpoint

/vcpcloud/api/padApi/inputText

Request Method

POST

Request Content Type

application/json

Request Body Parameters

Parameter Name	Example Value	Type	Required	Description
padCodes	ACP2505060777	String[]	Yes	Instance codes
text	hello123	String	Yes	Input text

Response Parameters

Parameter Name	Example Value	Type	Description
code	200	Integer	Status code
msg	success	String	Response message
ts	1736922808949	Long	Timestamp
data		Object[]
├─ padCode	AC32032	String	Instance code
├─ taskId	10004759	Long	Task ID
├─ vmStatus	0	String	Online status
├─ taskStatus	1	String	Task status

Request Example

{
   "padCodes": [
      "ACP250509FECQN33",
      "ACP250509T1VME44",
      "ACP25050917AYX11"
   ],
   "text": "12345678"
}

Response Example

{
     "msg": "success",
     "code": 200,
     "data": [
      {
         "padCode": "ACP250509FECQN33",
         "vmStatus": 0,
         "taskId": 10013014,
         "taskStatus": 1
      },
      {
         "padCode": "ACP250509T1VME44",
         "vmStatus": 0,
         "taskId": 10013015,
         "taskStatus": 1
      },
      {
         "padCode": "ACP25050917AYX11",
         "vmStatus": 0,
         "taskId": 10013016,
         "taskStatus": 1
      }
   ],
   "ts": 1746797852244
}

Simulate Send SMS

Simulate sending SMS to instance (supports batch). Limited to AOSP13/14.

API Endpoint

/vcpcloud/api/padApi/simulateSendSms

Request Method

POST

Request Content Type

application/json

Request Body Parameters

Parameter Name	Example Value	Type	Required	Description
padCodes	["ACN2505060777"]	String[]	Yes	Instance list (1-100)
senderNumber	13800000000	String	Yes	Sender number (no mainland; max 16 chars, digits/letters/space/+-)
smsContent	这是一条测试短信。	String	Yes	SMS content (max 127 chars)

Response Parameters

Parameter Name	Example Value	Type	Description
code	200	Integer	Status code
msg	success	String	Response message
ts	1736922808949	Long	Timestamp
traceId	ewb123abc	String	Trace ID
data	true	Boolean	Success

Request Example

{
  "padCodes": ["ACN2505060777"],
  "senderNumber": "13800000000",
  "smsContent": "这是一条测试短信。"
}

Response Example

{
  "code": 200,
  "msg": "success",
  "ts": 1736922808949,
  "traceId": "ewb123abc",
  "data": true
}

Reset GAID

Reset advertising ID (GAID) in cloud phone via instance code or group.

API Endpoint

/vcpcloud/api/padApi/resetGAID

Request Method

POST

Request Content Type

application/json

Request Body Parameters

Parameter Name	Example Value	Type	Required	Description
padCodes		String[]	Yes
├─	AC21020010001	String	Yes	Instance code
resetGmsType	GAID	String	Yes	Reset type: GAID
oprBy	zhangsan	String	No	Operator
taskSource	OPEN_PLATFORM	String	Yes	Task source: OPEN_PLATFORM

Response Parameters

Parameter Name	Example Value	Type	Description
code	200	Integer	Status code
msg	success	String	Response message
ts	1756021167163	Long	Timestamp
data		Object[]
├─ taskId	1	Integer	Task ID
├─ padCode	AC21020010001	String	Instance code
├─ vmStatus	1	Integer	Online status (0: offline; 1: online)

Request Example

{
   "padCodes": [
      "ACPXXXXXXXXXXXXXXX"
   ],
  "taskSource": "OPEN_PLATFORM",
  "oprBy": "admin",
  "resetGmsType": "GAID"
}

Response Example

{
    "code": 200,
    "msg": "success",
    "ts": 1717559681604,
    "data": [
         {
            "taskId": 88,
            "padCode": "AC22030010001",
            "vmStatus": 1
         },
         {
            "taskId": 89,
            "padCode": "AC22030010002",
            "vmStatus": 0
         }
      ]
}

Inject Audio to Instance Microphone

Inject audio file to instance microphone (PCM format only; convert first).

API Endpoint

/vcpcloud/api/padApi/injectAudioToMic

Request Method

POST

Request Content Type

application/json

Request Body Parameters

Parameter Name	Example Value	Type	Required	Description
padCodes	ACP2505060777	String[]	Yes	Instance codes
url	http://localhost/abc	String	No	Audio download URL (one of url/fileUniqueId)
fileUniqueId	8fc73d05371740008ea27a2707496a82	String	No	File unique ID (one of url/fileUniqueId)
enable	true	Boolean	Yes	Inject switch

Response Parameters

Parameter Name	Example Value	Type	Description
code	200	Integer	Status code
msg	success	String	Response message
ts	1736922808949	Long	Timestamp
data		Object[]
├─ padCode	AC32032	String	Instance code
├─ taskId	10004759	Long	Task ID
├─ vmStatus	0	String	Online status
├─ taskStatus	1	String	Task status

Request Example

{
  "padCodes": [
    "ACP250509FECQN33","ACP250509T1VME44","ACP25050917AYX11
  ],
  "url":"http://localhost/abc ",
  "fileUniqueId":"8a6d0df189ef4b0e83858fd9eeb7620c",
  "enable":true
}

Response Example

{
     "msg": "success",
     "code": 200,
     "data": [
      {
         "padCode": "ACP250509FECQN33",
         "vmStatus": 0,
         "taskId": 10013014,
         "taskStatus": 1
      },
      {
         "padCode": "ACP250509T1VME44",
         "vmStatus": 0,
         "taskId": 10013015,
         "taskStatus": 1
      },
      {
         "padCode": "ACP25050917AYX11",
         "vmStatus": 0,
         "taskId": 10013016,
         "taskStatus": 1
      }
   ],
   "ts": 1746797852244
}

Create Local Instance Backup

(Pending Launch)
Create backup for local instance.

API Endpoint

/vcpcloud/api/padApi/localPodBackup

Request Method

POST

Request Content Type

application/json

Request Body Parameters

Parameter Name	Example Value	Type	Required	Description
padCode	PAD_001	String	Yes	Instance code (max 64 chars)
backupName	backnameinfo	String	No	Backup name (max 128 chars)
backupPath	backup/db	String	No	Path (no leading /; default root /{backupID}/ ; max 256 chars)
ossConfig	{...}	Object	Yes	S3-compatible OSS config (permanent auth required)
├─ endpoint	oss-cn-shanghai.aliyuncs.com	String	Yes	OSS endpoint (max 128 chars)
├─ bucket	pad-backup	String	Yes	Bucket name (max 128 chars)
├─ accessKey	AKIA123456	String	Yes	Access key (max 128 chars)
├─ secretKey	xxxxxxx	String	Yes	Secret key (max 128 chars)
├─ protocol	https	String	Yes	Protocol: http or https (max 16 chars)
├─ region	cn-shanghai	String	Yes	Region (max 32 chars)
├─ securityToken	xxxxxxxxx	String	Yes if credentialType=2	Temporary token
├─ expiration	2025-12-01T21:38:49z	String	Yes if credentialType=2	Expiration
credentialType	1	Integer	No	Credential type: 1-permanent, 2-temporary

Response Parameters

Parameter Name	Example Value	Type	Description
code	200	Integer	Status code (200 success)
msg	success	String	Request status
ts	1758271736814	Long	Timestamp
data	{...}	Object	Task info
├─ taskId	59	Long	Task ID
├─ padCode	ACP250919HTTMIBQ	String	Instance code
├─ vmStatus	0	Integer	Online status: 0-offline, 1-online
├─ taskStatus	1	Integer	Task status: -1 exists, 1 added
├─ errMsg	null	String	Error message
├─ backupName	backupName	String	Backup name
├─ backupId	bkp-ACP250919HTTMIBQ-1758271735910	String	Backup ID
traceId	eyj68nk6dnuo	String	Trace ID

Request Example

{
  "padCode": "ACP25091XXXXXX15",
  "backupName": "backnameinfo",
  "backupPath": "backup/data/",
  "credentialType": 1,
  "ossConfig": {
    "endpoint": "oss-cn-xxxxx.xxxxx.com",
    "bucket": "armcloud-cn",
    "accessKey": "LTAI5txxxxxxxYC",
    "secretKey": "kjgvYxxxxxxxxxxx8URWU",
    "protocol": "httpxxxx",
    "region": "cn-xxxxx"
  }
}

Response Example

{
  "code": 200,
  "msg": "success",
  "ts": 1758271736814,
  "data": {
    "taskId": 59,
    "padCode": "ACP25091XXXXXX15",
    "vmStatus": 0,
    "taskStatus": 1,
    "errMsg": null,
    "backupName": "backnameinfo",
    "backupId": "bkp-ACP25091XXXXXX15-1758271735910"
  },
  "traceId": "eyj68nk6dnuo"
}

Error Codes

Error Code	Error Description	Suggestion
220025	Other task running/pending on local instance	Wait for task completion
220026	Only local instances supported	Confirm local instance
220029	Instance not running	Confirm running status
220033	CBS version too low for backup/restore	Upgrade CBS to latest

Create Local Instance Restore

(Pending Launch)
Restore from local instance backup file.

API Endpoint

/vcpcloud/api/padApi/localPodRestore

Request Method

POST

Request Content Type

application/json

Request Body Parameters

Parameter Name	Example Value	Type	Required	Description
backupId	bkp-ACP250917XSYESH3-1758097064458	String	Yes	Backup ID (max 128 chars)
padCode	ACP250917CLAQJ15	String	Yes	Instance code (max 64 chars)
ossConfig	{...}	Object	Yes	S3-compatible OSS config
├─ endpoint	oss-cn-shanghai.aliyuncs.com	String	Yes	OSS endpoint
├─ bucket	pad-backup	String	Yes	Bucket
├─ accessKey	AKIA123456	String	Yes	Access key
├─ secretKey	xxxxxxx	String	Yes	Secret key
├─ protocol	https	String	Yes	Protocol
├─ region	cn-shanghai	String	Yes	Region
├─ securityToken	xxxxxxxxx	String	Yes if credentialType=2	Temporary token
├─ expiration	2025-12-01T21:38:49z	String	Yes if credentialType=2	Expiration
credentialType	1	Integer	No	Credential type

Response Parameters

Parameter Name	Example Value	Type	Description
code	200	Integer	Status code
msg	success	String	Request status
ts	1758271736814	Long	Timestamp
data	{...}	Object	Task info
├─ taskId	59	Long	Task ID
├─ padCode	ACP250919HTTMIBQ	String	Instance code
├─ vmStatus	0	Integer	Online status
├─ taskStatus	1	Integer	Task status
├─ errMsg	null	String	Error message
traceId	eyj68nk6dnuo	String	Trace ID

Request Example

{
  "padCode": "ACP25091XXXXXJ15",
  "backupId": "bkp-ACP25091XXXXXJ15-1758097064458",
  "credentialType": 1
}

Response Example

{
  "code": 200,
  "msg": "success",
  "ts": 1758271736814,
  "data": {
    "taskId": 59,
    "padCode": "ACP25091XXXXXX15",
    "vmStatus": 0,
    "taskStatus": 1,
    "errMsg": null
  },
  "traceId": "eyj68nk6dnuo"
}

Error Codes

Error Code	Error Description	Suggestion
220025	Other task running/pending	Wait
220027	Backup file not exist	Check file
220030	Instance not running or abnormal	Confirm status
220031	Backup not belong to current user	Confirm ownership
220032	Backup ID instance info not exist	Check backup ID
220033	CBS version too low	Upgrade CBS

Local Instance Backup Query

(Pending Launch)
Get available backups for local instance by code.

API Endpoint

/vcpcloud/api/padApi/localPodBackupSelectPage

Request Method

POST

Request Content Type

application/json

Request Body Parameters

Parameter Name	Example Value	Type	Required	Description
page	1	Integer	No	Current page
rows	10	Integer	No	Records per page
padCodes		String[]	Yes
├─ padCode	ACP5C24S9G6xxxxx	String	Yes	Instance code (max 100)

Response Parameters

Parameter Name	Example Value	Type	Description
code	200	Integer	Status code
msg	success	String	Response message
ts	1756021167163	Long	Timestamp
data		Object
├─ page	1	Integer	Current page
├─ rows	10	Integer	Records per page
├─ size	1	Integer	Current count
├─ total	1	Integer	Total
├─ totalPage	1	Integer	Total pages
├─ pageData		Object[]	List
├─ ├─ padCode	ACP5C24S9G6xxxxx	String	Instance code
├─ ├─ backupId	bkp-xxxxxS4QBMGEW1ZX-1764728535556	String	Backup ID
├─ ├─ backupName	backupName	String	Backup name
├─ ├─ backupPath	backup/db	String	Backup path
├─ ├─ endpoint	backupName	String	Endpoint
├─ ├─ bucket	pad-backup	String	Bucket
├─ ├─ protocol	https	String	Protocol
├─ ├─ region	cn-shanghai	String	Region
traceId	eyj68nk6dnuo	String	Trace ID

Request Example

{
  "padCodes":["ACP5C24S9G6xxxxx"],
  "page":1,
  "rows":10
}

Response Example

{
  "code": 200,
  "msg": "success",
  "ts": 1764819200220,
  "data": {
    "page": 1,
    "rows": 10,
    "size": 1,
    "total": 1,
    "totalPage": 1,
    "pageData": [
      {
        "padCode": "ACP5C24S9G6xxxxx",
        "backupId": "bkp-xxxxxS4QBMGEW1ZX-1764728535556",
        "backupName": "android13-xxxx-虚拟机-img-25112665572-王者荣耀+抖音",
        "backupPath": "backup/data/",
        "endpoint": "oss-cn-xxxxxx.xxxxxxx.com",
        "bucket": "armcloud-xx",
        "protocol": "https",
        "region": "cn-hongkong"
      }
    ]
  },
  "traceId": "f61kq5vu5ts0"
}

Clear Processes and Return to Desktop

(Pending Launch)
Clear all processes except system and return to desktop.

API Endpoint

/vcpcloud/api/padApi/cleanAppHome

Request Method

POST

Request Content Type

application/json

Request Body Parameters

Parameter Name	Example Value	Type	Required	Description
padCodes	ATP250814USYXXXX	String[]	Yes	Instance codes

Response Parameters

Parameter Name	Example Value	Type	Description
code	200	Integer	Status code
msg	success	String	Response message
ts	1736922808949	Long	Timestamp
traceId	euz60azzc7i8	String	Trace ID
data		Object[]
├─ padCode	AC32032	String	Instance code
├─ taskId	10004759	Long	Task ID
├─ vmStatus	0	String	Online status
├─ taskStatus	1	String	Task status

Request Example

{
    "padCodes": [
        "ATP250814USYXXXX"
    ]
}

Response Example

{
    "msg": "success",
        "traceId": "euz60azzc7i8",
        "code": 200,
        "data": [
        {
            "padCode": "ATP250814USYXXXX",
            "vmStatus": 0,
            "taskId": 68951,
            "taskStatus": 1
        }
    ],
        "ts": 1755172215886
}

Unmanned Live Streaming

(Pending Launch)
Instance video injection (only img-25092692759 image supported currently). Use injectUrl or injectUrls (at least one, not both; max 5 for injectUrls).

API Endpoint

/vcpcloud/api/padApi/unmannedLive

Request Method

POST

Request Content Type

application/json

Request Body Parameters

Parameter Name	Example Value	Type	Required	Description
padCodes	ACN384345141346304	String[]	Yes	Instances (1-100)
injectSwitch	true	Boolean	No	Enable injection (true: on; false: off; default false)
injectLoop	false	Boolean	No	Loop playback (default false)
injectUrl	https://file.vmoscloud.com/userFile/1eea385b2a6ba3942ebf642badf39aa0.mp4	String	No	Single video URL (http/https/rtmp:// or local; one with injectUrls)
injectUrls	["https://file.vmoscloud.com/userFile/1eea385b2a6ba3942ebf642badf39aa0.mp4","rtmp://example.com/live"]	String[]	No	Video URL list (max 5; one with injectUrl)

Response Parameters

Parameter Name	Example Value	Type	Description
code	200	Integer	Status code
msg	success	String	Response message
ts	1759134336311	Long	Timestamp
traceId	ezispr1m30n4	String	Trace ID
data		Object[]
├─ padCode	ACN384345141346304	String	Instance code
├─ taskId	20503	Long	Task ID
├─ vmStatus	0	String	Online status
├─ taskStatus	1	String	Task status
├─ errMsg	null	String	Error message

Request Example

{
        "padCodes": ["ACN384345141346304"],
        "injectSwitch": true,
        "injectLoop": false,
        "injectUrl": "https://file.vmoscloud.com/userFile/1eea385b2a6ba3942ebf642badf39aa0.mp4",
        "injectUrls": [
          "https://file.vmoscloud.com/userFile/1eea385b2a6ba3942ebf642badf39aa0.mp4",
          "rtmp://example.com/live/unmanned01"
        ]
}

Response Example

{
    "code": 200,
        "msg": "success",
        "ts": 1759134336311,
        "data": [
        {
            "taskId": 20503,
            "padCode": "ACN384345141346304",
            "vmStatus": 0,
            "taskStatus": 1,
            "errMsg": null
        }
    ],
        "traceId": "ezispr1m30n4"
}

Image Injection

(Pending Launch)
Instance image injection.

API Endpoint

/vcpcloud/api/padApi/injectPicture

Request Method

POST

Request Content Type

application/json

Request Body Parameters

Parameter Name	Example Value	Type	Required	Description
padCodes	ACN2510166WZUPCJ	String[]	Yes	Instances (1-100)
injectSwitch	true	Boolean	No	Enable (true: on; false: off; default false)
injectLoop	false	Boolean	No	Loop (default false)
injectUrl	https://file.vmoscloud.com/userFile/ac4e112d72f9ed724101f510e774001f.JPG	String	Yes	Image URL (http/https/rtmp://)

Response Parameters

Parameter Name	Example Value	Type	Description
code	200	Integer	Status code
msg	success	String	Response message
ts	1759134336311	Long	Timestamp
traceId	ezispr1m30n4	String	Trace ID
data		Object[]
├─ padCode	ACN384345141346304	String	Instance code
├─ taskId	20503	Long	Task ID
├─ vmStatus	0	String	Online status
├─ taskStatus	1	String	Task status
├─ errMsg	null	String	Error message

Request Example

{
        "padCodes": ["ACN2510166WZUPCJ"],
        "injectSwitch": true,
        "injectLoop": false,
        "injectUrl": "https://file.vmoscloud.com/userFile/ac4e112d72f9ed724101f510e774001f.JPG"
}

Response Example

{
    "code": 200,
        "msg": "success",
        "ts": 1759134336311,
        "data": [
        {
            "taskId": 28247,
            "padCode": "ACN2510166WZUPCJ",
            "vmStatus": 0,
            "taskStatus": 1,
            "errMsg": null
        }
    ],
        "traceId": "ezispr1m30n4"
}

Application Management

App Start

Start an app on an instance based on the instance ID and app package name.

API Endpoint

/vcpcloud/api/padApi/startApp

Request Method

POST

Request Data Type

application/json

Request Body Parameters

Parameter Name	Example Value	Parameter Type	Required	Description
pkgName	xxx.test.com	String	Yes	Package Name
padCodes		String[]	Yes
├─	AC22010020062	String	Yes	Instance Code

Response Parameters

Parameter Name	Example Value	Parameter Type	Description
code	200	Integer	Status Code
msg	success	String	Response Message
ts	1756021167163	Long	Timestamp
data		Object[]
├─ taskId	1	Integer	Task ID
├─ padCode	AC22010020062	String	Instance Code
├─ vmStatus	1	Integer	Instance Online Status (0: Offline; 1: Online)

Request Example

{
	"padCodes": [
		"AC22010020062"
	],
	"pkgName": "xxx.test.com"
}

Response Example

{
	"code": 200,
	"msg": "success",
	"ts": 1717570663080,
	"data": [
		{
			"taskId": 24,
			"padCode": "AC22010020062",
			"vmStatus": 1
		}
	]
}

Error Codes

Error Code	Error Description	Recommended Action
110008	Failed to start the app	Restart the cloud machine and try starting the app again

Stop App

Perform the operation of stopping an app on an instance based on the instance ID and app package name.

API Endpoint

/vcpcloud/api/padApi/stopApp

Request Method

POST

Request Data Type

application/json

Request Body Parameters

Parameter Name	Example Value	Parameter Type	Required	Description
pkgName	xxx.test.com	String	Yes	Package Name
padCodes		String[]	Yes	Instance IDs
├─	AC22010020062	String	Yes	Instance ID

Response Parameters

Parameter Name	Example Value	Parameter Type	Description
code	200	Integer	Status Code
msg	success	String	Response Message
ts	1756021167163	Long	Timestamp
data		Object[]	Data List
├─taskId	1	Integer	Task ID
├─padCode	AC22010020062	String	Instance ID
├─vmStatus	1	Integer	Instance Online Status (0: Offline; 1: Online)

Request Example

{
	"padCodes": [
		"AC22010020062"
	],
	"pkgName": "xxx.test.com"
}

Response Example

{
	"code": 200,
	"msg": "success",
	"ts": 1717570663080,
	"data": [
		{
			"taskId": 24,
			"padCode": "AC22010020062",
			"vmStatus": 1
		}
	]
}

Error Codes

Error Code	Error Description	Suggested Action
110010	Failed to stop app	Restart the cloud machine and close the app

Application Restart

Restart an application on an instance based on the instance ID and application package name.

API Endpoint

/vcpcloud/api/padApi/restartApp

Request Method

POST

Request Data Type

application/json

Request Body Parameters

Parameter Name	Example Value	Parameter Type	Required	Description
pkgName	xxx.test.com	String	Yes	Package name
padCodes		String[]	Yes	Instance IDs
├─	AC22010020062	String	Yes	Instance ID

Response Parameters

Parameter Name	Example Value	Parameter Type	Description
code	200	Integer	Status code
msg	success	String	Response message
ts	1756021167163	Long	Timestamp
data		Object[]	Response data
├─ taskId	1	Integer	Task ID
├─ padCode	AC22010020062	String	Instance ID
├─ vmStatus	1	Integer	Instance online status (0: Offline; 1: Online)

Request Example

{
	"padCodes": [
		"AC22010020062"
	],
	"pkgName": xxx.test.com
}

Response Example

{
	"code": 200,
	"msg": "success",
	"ts": 1717570663080,
	"data": [
		{
			"taskId": 24,
			"padCode": "AC22010020062",
			"vmStatus": 1
		}
	]
}

Error Codes

Error Code	Error Description	Suggested Action
110009	Failed to stop app	Restart the cloud machine and close the app

Error Codes

Error Code	Description	Suggested Action
110009	Application restart failed	Restart the cloud machine and then start the application

Instance installed application list query

Query the instance installed application list information.

API Address:

/vcpcloud/api/padApi/listInstalledApp

Request Method:

POST

Request Data Type:

application/json

Request Body Parameters:

Parameter Name	Example Value	Parameter Type	Required	Description
padCodes		String[]	Yes	Instance identifier list
├─	AC22010020062	String	Yes	Instance identifier
appName		String	否	Application name

Response Parameters:

Parameter Name	Example Value	Parameter Type	Description
code	200	Integer	Status code
msg	success	String	Response message
ts	1713773577581	Long	Timestamp
data		Object[]
├─ padCode	AC22010020062	String	Instance ID
├─ apps		Object[]	Application list
│ ├─ appName	TapTap	String	Application name
│ ├─ packageName	com.taptap.global	String	Application package name
│ ├─ versionName	3.49.0-full.100000	String	Application version name
│ ├─ versionCode	349001000	String	Application version code
│ ├─ appState	0	Integer	0 Completed 1 Installing 2 Downloading

Request Example


{
    "padCodes": ["AC32010780841"],
    "appName": null
}

Response Example

{
    "msg": "success",
        "code": 200,
        "data": [
            {
                "padCode": "AC32010780841",
                "apps": [
                    {
                        "appName": "TapTap",
                        "packageName": "com.taptap.global",
                        "versionName": "3.49.0-full.100000",
                        "versionCode": "349001000",
                        "appState": 0
                    }
                ]
            }
        ], 
        "ts": 1740020993436
}

Task Management

Instance Operation Task Details

Query the detailed execution result of a specified instance operation task.

API Address:

/vcpcloud/api/padApi/padTaskDetail

Request Method:

POST

Request Data Type:

application/json

Request Body Parameters:

Parameter Name	Example Value	Parameter Type	Required	Description
taskIds		Integer[]	Yes	List of task IDs
├─ taskId	1	Integer	Yes	Task ID

Response Parameters:

Parameter Name	Example Value	Parameter Type	Description
code	200	Integer	Status code
msg	success	String	Response message
ts	1756021167163	Long	Timestamp
data		Object[]	Subtask list details
├─ taskId	1	Integer	Subtask ID
├─ padCode	VP22020020793	String	Instance identifier
├─ taskStatus	2	String	Task status (-1: all failed; -2: partial failure; -3: canceled; -4: timeout; 1: pending execution; 2: executing; 3: completed)
├─ endTime	1713429401000	Long	Subtask end timestamp
├─ taskContent	“”	String	Task content
├─ taskResult	“”	String	Task result
├─ errorMsg	“”	String	Error message

Request Example

{
	"taskIds":[1,2]
}

Response Example

{
	"code": 200,
	"msg": "success",
	"ts": 1716283460673,
	"data": [
		{
			"taskId": 1,
			"padCode": "AC22030022441",
			"taskStatus": 2,
			"endTime": 1713429401000,
			"taskContent": null,
			"taskResult": null
		},
		{
			"taskId": 2,
			"padCode": "AC22030022442",
			"taskStatus": 2,
			"endTime": 1713429401001,
			"taskContent": null,
			"taskResult": null
		}
	]
}

File Task Details

Query the detailed execution result of a specified file task.

API Address:

/vcpcloud/api/padApi/fileTaskDetail

Request Method:

POST

Request Data Type:

application/json

Request Body Parameters:

Parameter Name	Example Value	Parameter Type	Required	Description
taskIds		Integer[]	Yes	List of task IDs
├─ taskId	1	Integer	Yes	Task ID

Response Parameters:

Parameter Name	Example Value	Parameter Type	Description
code	200	Integer	Status code
msg	success	String	Response message
ts	1756021167163	Long	Timestamp
data		Object[]	Task list details
├─ taskId	1	Integer	Subtask ID
├─ appId	134	Long	Application ID
├─ fileUniqueId	e2c07491309858c5cade4bfc44c03724	String	Unique file identifier
├─ fileName	xx.apk	String	File name
├─ taskStatus	2	Integer	Task status (-1: all failed; -2: partial failure; -3: canceled; -4: timeout; 1: pending execution; 2: executing; 3: completed)
├─ endTime	1713429401000	Long	Subtask end timestamp

Request Example

{
	"taskIds":[
		1,2
	]
}

Response Example

{
	"code": 200,
	"msg": "success",
	"ts": 1716283460673,
	"data": [
		{
			"taskId": 1,
			"appId": 134,
			"fileUniqueId": "e2c07491309858c5cade4bfc44c03724",
			"fileName": "xx.apk",
			"taskStatus": 2,
			"endTime": 1713429401000
		},
		{
			"taskId": 2,
			"appId": 135,
			"fileUniqueId": "e2c07491309858c5cade4bfc43c03725",
			"fileName": "xx.apk",
			"taskStatus": 2,
			"endTime": 1713429401001
		}
	]
}

Automation Management

When performing automated tasks, do not operate on the cloud machine by performing actions such as rebooting, resetting, upgrading the image, or replacing machines, as this could interfere with the automated tasks.

Automated Task List Query

Query the list of automated tasks.

API Endpoint

/vcpcloud/api/padApi/autoTaskList

Request Method

POST

Request Data Type

application/json

Request Body Parameters

Parameter Name	Example Value	Parameter Type	Required	Description
taskIds		Long[]	No	Task ID array
taskType	1	Integer	No	Task type: 1-login, 2-edit profile, 3-search short videos, 4-randomly browse videos, 5-publish video, 6-publish gallery
page	1	Integer	Yes	Page number
rows	10	Integer	Yes	Number of records per page

Response Parameters

Parameter Name	Example Value	Parameter Type	Description
msg	success	String	Response message
code	200	Integer	Status code
ts	1736327056700	Long	Timestamp
data		Object	Data details
├─ records		Object[]	Record list
│ ├─ taskId	115	Integer	Task ID
│ ├─ userId	14114	Integer	User ID
│ ├─ equipmentId	106588	Integer	Equipment ID
│ ├─ padCode	AC32010180421	String	Instance ID
│ ├─ padName	zzzzz	String	Instance name
│ ├─ taskType	1	Integer	Task type: 1-login, 2-edit profile, 3-search short videos, 4-randomly browse videos, 5-publish video, 6-publish gallery
│ ├─ taskName	testAdd	String	Task name
│ ├─ executionStatus	0	Integer	Execution status: -2-cancelled task, -1-failed, 0-pending, 1-in progress, 2-successful
│ ├─ plannedExecutionTime	2025-01-09 00:00:00	String	Planned execution time
│ ├─ executionEndTime	null	String	Execution end time
│ ├─ createdTime	2025-01-08 14:25:01	String	Creation time
│ ├─ failureReason	null	String	Failure reason
├─ total	46	Integer	Total records
├─ size	10	Integer	Number of records per page
├─ current	1	Integer	Current page
├─ pages	5	Integer	Total pages

Request Example

{
    "page": 1,
    "rows": 10
}

Response Example

{
	"msg": "success",
	"code": 200,
	"data": {
		"records": [
			{
				"id": 121,
				"taskId": 121,
				"userId": 14114,
				"equipmentId": 106653,
				"padCode": "AC32010180522",
				"padName": "V04",
				"taskType": 1,
				"taskName": "testAdd",
				"executionStatus": 2,
				"plannedExecutionTime": "2025-01-08 18:02:00",
				"executionEndTime": "2025-01-08 18:08:11",
				"createdTime": "2025-01-08 18:01:03",
				"failureReason": null
			}
		],
		"total": 46,
		"size": 10,
		"current": 1,
		"pages": 5
	},
	"ts": 1736331989341
}

Create Automation Task

Create an automation task. Make sure to pass the correct device number (the cloud phone list interface will return the device number). The task is mainly bound to the device number. If a device swap occurs before execution, it will not affect task loss. (Asynchronous, the system will check if the TK app is installed on the cloud phone. If not, it will automatically download the TK app before executing the task. Do not manually operate the cloud phone during the TK download and task execution). The request parameters for different tasks may vary; examples will be provided.

API Endpoint

/vcpcloud/api/padApi/addAutoTask

Request Method

POST

Request Data Type

application/json

Request Body Parameters

Parameter Name	Example Value	Parameter Type	Required	Description
taskName	testAdd	String	Yes	Task name
remarks	test	String	No	Remarks
taskType	1	Integer	Yes	Task type: 1-login, 2-edit profile, 3-search short videos, 4-randomly browse videos, 5-publish video, 6-publish gallery
list		Object[]	Yes	Task list
├─ equipmentId	106653	Integer	Yes	Equipment ID
├─ padCode	AC32010180522	String	Yes	Instance ID
├─ plannedExecutionTime	2025-01-08 17:20:00	String	Yes	Planned execution time
├─ addInfo	Refer to the request example	JSONObject	Yes	Task parameters (Note: Follow the corresponding format based on the task type, otherwise the task will fail)

Request Example

{
    "taskName": "testAdd",
    "remarks": "test",
    "taskType": 1,
    "list": [
        {
            "equipmentId": 106653,
            "padCode": "AC32010180522",
            "plannedExecutionTime": "2025-01-08 17:20:00",
            "addInfo": {
                "password": "zhouxi12....",
                "username": "zzx833454@gmail.com"
            }
        }
    ]
}

Login Task Parameters (Task Type - taskType: 1)

Parameter Name	Example Value	Parameter Type	Required	Description
password	zzxxxx@gmail.com	String	Yes	Account
username	zzxxxx@gmail.com	String	Yes	Password

Edit Profile Task Parameters (Task Type - taskType: 2)

Parameter Name	Example Value	Parameter Type	Required	Description
link	https://xxxx.png	String	Yes	Avatar URL (greater than 250x250)
username	test	String	Yes	Name

Search Short Video Task Parameters (Task Type - taskType: 3)

Parameter Name	Example Value	Parameter Type	Required	Description
tag	Title	String	Yes	Tag
timeout	10	Integer	Yes	Viewing duration (seconds) Note: The maximum time is 2 hours, otherwise the task will time out and fail

Random Video Browsing Task Parameters (Task Type - taskType: 4)

Parameter Name	Example Value	Parameter Type	Required	Description
timeout	10	Integer	Yes	Viewing duration (seconds) Note: The maximum time is 2 hours, otherwise the task will time out and fail
tag	""	String	No	Tag

Publish Video Task Parameters (Task Type - taskType: 5)

Parameter Name	Example Value	Parameter Type	Required	Description
link	https://xxxx	String	No	Video OSS URL
copywriting	test	String	Yes	Copywriting
productId	null	String	No	product id

Publish Image Gallery Task Parameters (Task Type - taskType: 6)

Parameter Name	Example Value	Parameter Type	Required	Description
links	[https://xxxx]	array[String]	Yes	Image OSS URLs (up to ten images)
copywriting	test	String	Yes	Copywriting
bgm	bgm	String	Yes	Background music name

Video like and comment task parameters (task type - taskType: 7)

Parameter name	Example value	Parameter type	Required	Parameter description
timeout	10	Integer	Yes	Watching time (seconds) Note: Up to 2 hours, otherwise the task will time out and fail
tag	""	String	No	Tag
contents	["wow"]	array[String]	No	Comment content Note: Currently only 1 is supported, and it will be expanded later

Live broadcast heating task parameters (task type - taskType: 8)

Parameter name	Example value	Parameter type	Required	Parameter description
timeout	10	Integer	Yes	Watching time (seconds) Note: Up to 2 hours, otherwise the task will time out and fail
liveRoomId	"xlavandulax"	String	Yes	Anchor ID
contents	"wow"	String	Yes	Comment content

Response Parameters

Parameter Name	Example Value	Parameter Type	Description
code	0	Integer	Status Code: 0 - Success
msg	success	String	Response Message
ts	1736327056700	Long	Timestamp
data		Object {}	Subtask list details
├─ taskIds		Long[]	Task ID Array

Response Example

{
	"msg": "success",
	"code": 200,
	"taskIds": [
		116
	],
	"ts": 1736327380399
}

Automated Task Retry

Automated task retry.

API Endpoint

/vcpcloud/api/padApi/reExecutionAutoTask

Request Method

POST

Request Data Type

application/json

Request Body Parameters

Parameter Name	Example Value	Parameter Type	Required	Description
taskIds		Long[]	Yes	Task ID array
plannedExecutionTime	2025-01-08 17:30:00	Date	Yes	Planned execution time

Response Parameters

Parameter Name	Example Value	Parameter Type	Description
code	200	Integer	Status Code
msg	success	String	Response Message
data		Object {}	Subtask list details
ts	1736327056700	Long	Timestamp
├─ taskIds		Long[]	New task ID array

Request Example

{
    "taskIds": [
        109
    ],
    "plannedExecutionTime": "2025-01-08 17:30:00"
}

Response Example

{
	"msg": "success",
	"code": 200,
	"taskIds": [
		118
	],
	"ts": 1736327771611
}

Automated Task Cancellationlation

Automated task cancellation.

API Endpoint

/vcpcloud/api/padApi/cancelAutoTask

Request Method

POST

Request Data Type

application/json

Request Body Parameters

Parameter Name	Example Value	Parameter Type	Required	Description
taskIds		Long[]	Yes	Task ID array

Response Parameters

Parameter Name	Example Value	Parameter Type	Description
code	200	Integer	Status Code
msg	success	String	Response Message
ts	1736327056700	Long	Timestamp

Request Example

{
    "taskIds": [
        118
    ]
}

Response Example

{
	"msg": "success",
	"code": 200,
	"ts": 1736327841671
}

Cloud Phone Management

Create Cloud Phone

Create a new cloud phone. (Note that the purchased product package must be available on the web platform, otherwise the purchase will fail.)

API Endpoint

/vcpcloud/api/padApi/createMoneyOrder

Request Method

POST

Request Data Type

application/json

Request Body Parameters

Parameter Name	Example Value	Parameter Type	Required	Description
androidVersionName	Android13	String	Yes	Android version: Android10、Android13, Android14
goodId	1	Integer	Yes	Product ID (corresponding to the Product ID value of SKU Package List)
goodNum	1	Integer	Yes	Product quantity
autoRenew	true	Boolean	Yes	Whether to auto-renew (enabled by default)
equipmentId	106626,106627	String	Yes	Renewal device IDs (comma separated for multiple devices)

Response Parameters

Parameter Name	Example Value	Parameter Type	Description
msg	success	String	Response message
code	200	Integer	Status code
data		Object[]	Data list
├─ id	7644	Integer	Unique data identifier
├─ orderId	VMOS-CLOUD173630666722957907	String	Order number
├─ equipmentId	106662	Integer	Equipment ID
├─ createTime	2025-01-08 11:24:31	String	Creation time
├─ creater	14114	String	Creator
ts	1736306672346	Long	Timestamp

Request Example

{
    "androidVersionName": "Android13",
    "goodId": 1,
    "goodNum": 1,
    "autoRenew": true
}

Response Example

{
	"msg": "success",
	"code": 200,
	"data": [
		{
			"id": 7644,
			"orderId": "VMOS-CLOUD173630666722957907",
			"equipmentId": 106662,
			"createTime": "2025-01-08 11:24:31",
			"creater": "14114"
		}
	],
	"ts": 1736306672346
}

Cloud Phone List

Cloud phone list.

API Endpoint

/vcpcloud/api/padApi/userPadList

Request Method

POST

Request Data Type

application/json

Request Body Parameters

Parameter Name	Example Value	Parameter Type	Required	Description
padCode	null	String	No	Instance code
equipmentIds		Integer[]	No	Array of equipment IDs

Response Parameters

Parameter Name	Example Value	Parameter Type	Description
code	200	Integer	Status code
msg	success	String	Response message
ts	1736235894274	Long	Timestamp
data		Object[]	Data list
├─ padCode	AC32010180421	String	Cloud phone code
├─ deviceIp	172.30.5.43	String	Cloud phone physical machine IP
├─ padIp	10.254.21.225	String	Cloud phone virtual IP
├─ cvmStatus	100	Integer	Cloud phone status (100 - normal, 101 - capturing screenshot, 102 - restarting, 103 - resetting, 104 - abnormal)
├─ screenshotLink	https://XXXXXX.png	String	Cloud phone screenshot link
├─ equipmentId	106626	Integer	Equipment ID
├─ userId	14114	Integer	User ID
├─ status	1	Integer	Device status
├─ padName	V08	String	Cloud phone display name
├─ bootTime	1735643626263	Long	Cloud phone usage time
├─ cumulativeUseTime	null	Object	Total device usage time
├─ lastBackupTime	null	Object	Last backup time
├─ maintainContent	null	Object	Maintenance content
├─ goodId	1	Integer	Product ID
├─ goodName	i18n_Android13-V08	String	Product name
├─ signExpirationTime	2025-01-31 19:13:46	String	Signed cloud phone expiration time
├─ signExpirationTimeTamp	1738322026000	Long	Signed cloud phone expiration timestamp
├─ supplierType	5	String	Supplier type
├─ androidVersionAvatar	https://XXXX.png	String	Android version avatar
├─ configName	V08	String	Product model name
├─ androidVersionAvatar2	https://XXX.png	String	Android version avatar 2
├─ androidVersionAvatar3	https://XXX.png	String	Android version avatar 3
├─ androidVersion	13	String	Android version
├─ authorizedUserId	null	Object	Authorized user ID
├─ authorizedExpirationTime	null	Object	Authorization expiration time
├─ authorizedExpirationTimeTamp	null	Object	Authorization expiration timestamp
├─ changeConfig	1	Integer	Support for configuration change (0 - no, 1 - yes)
├─ createTime	2024-12-31 19:13:46	String	Creation time
├─ proxyIp	null	Object	Proxy IP address
├─ remark		String	Remark
├─ proxyId	null	Object	Proxy IP information
├─ ipAddress	null	Object	IP address location
├─ publicIp	null	Object	Public IP
├─ groupSort	null	Object	Group sorting order

Cloud Phone Status

Status Code	Description
99	Loading
100	Normal
101	Getting Screenshot
102	Rebooting
103	Resetting
104	Reboot Failed
105	Reset Failed
106	Maintenance
107	Upgrading Image
108	Migrating Instance
109	Migration Failed
111	Device Configuration
112	Anti-Fraud Lockdown
113	Config Change
114	Over Selling
115	Changing Zone
116	Cleaning Memory
119	Initializing Cloud Machine
120	One-click New Machine Initialization
121	Task Execution in Progress
201	Backing Up
202	Restoring

Request Example

{
    "padCode": null,
    "equipmentIds": [
        106626
    ]
}

Response Example

{
  "msg": "success",
  "code": 200,
  "ts": 1736235894274,
  "data": [
    {
      "padCode": "AC32010180421",
      "deviceIp": "172.30.5.43",
      "padIp": "10.254.21.225",
      "cvmStatus": 100,
      "screenshotLink": "https://XXXXXX.png",
      "equipmentId": 106626,
      "userId": 14114,
      "status": 1,
      "padName": "V08",
      "bootTime": 1735643626263,
      "cumulativeUseTime": null,
      "lastBackupTime": null,
      "maintainContent": null,
      "goodId": 1,
      "goodName": "i18n_Android13-V08",
      "signExpirationTime": "2025-01-31 19:13:46",
      "signExpirationTimeTamp": 1738322026000,
      "supplierType": "5",
      "androidVersionAvatar": "https://XXXX.png",
      "configName": "V08",
      "androidVersionAvatar2": "https://XXX.png",
      "androidVersionAvatar3": "https://XXX.png",
      "androidVersion": "13",
      "authorizedUserId": null,
      "authorizedExpirationTime": null,
      "authorizedExpirationTimeTamp": null,
      "changeConfig": 1,
      "createTime": "2024-12-31 19:13:46",
      "proxyIp": null,
      "remark": "",
      "proxyId": null,
      "ipAddress": null,
      "publicIp": null, 
        "groupName": null,
      "groupSort": null
    }
  ]
}

Cloud Phone Information Query

Query cloud phone information.

API Endpoint

/vcpcloud/api/padApi/padInfo

Request Method

POST

Request Data Type

application/json

Request Body Parameters

Parameter Name	Example Value	Type	Required	Description
padCode	AC32010180421	String	Yes	Instance ID

Response Parameters

Parameter Name	Example Value	Type	Description
msg	success	String	Response Message
code	200	Integer	Status Code
data		Object	Response Data
├─ explain	English	String	Language - Explanation
├─ simCountry	SG	String	SIM Card Country
├─ country	SG	String	Country
├─ padCode	AC32010180421	String	Instance ID
├─ padType	V08	String	Device Model
├─ bluetoothAddress	3A:1F:4B:9C:2D:8E	String	Bluetooth Address
├─ initializationData	{"explain":"English", ...}	String	Device Information
├─ latitude	1.3398	String	Latitude
├─ ipAddress	Hong Kong	String	IP Address
├─ timeZone	Asia/Singapore	String	Time Zone
├─ publicIp	192.169.96.14	String	Public IP
├─ phoneNumber	+6510633153	String	Virtual Phone Number
├─ androidVersion	Android13	String	Android Version
├─ wlanMac	4c:7f:11:2f:a6:cc	String	WLAN MAC Address
├─ padName	V08	String	Pad Name
├─ simIso	M1	String	SIM Card ISO
├─ longitude	103.6967	String	Longitude
├─ operatorNumeric	52503	Integer	Operator Number
├─ padImei	525036719631842	String	IMEI
ts	1736239152927	Long	Timestamp

Request Example

{
    "padCode": null
}

Response Example

{
	"msg": "success",
	"code": 200,
	"data": {
		"explain": "English",
		"simCountry": "SG",
		"country": "SG",
		"padCode": "AC32010180421",
		"padType": "V08",
		"bluetoothAddress": "3A:1F:4B:9C:2D:8E",
		"initializationData": "{\"explain\":\"English\",\"country\":\"SG\",\"simJson\":{\"simCountry\":\"SG\",\"operatorShortname\":\"M1\",\"imei\":\"979706209497838\",\"imsi\":\"525036719631842\",\"phonenum\":\"6510633153\",\"operatorNumeric\":\"52503\"},\"latitude\":\"1.3398\",\"timeZone\":\"Asia/Singapore\",\"language\":\"en\",\"longitude\":\"103.6967\"}",
		"latitude": "1.3398",
		"ipAddress": "Hong Kong",
		"timeZone": "Asia/Singapore",
		"publicIp": "192.169.96.14",
		"phoneNumber": "+6510633153",
		"androidVersion": "Android13",
		"wlanMac": "4c:7f:11:2f:a6:cc",
		"padName": "V08",
		"simIso": "M1",
		"longitude": "103.6967",
		"operatorNumeric": 52503,
		"padImei": "525036719631842"
	},
	"ts": 1736239152927
}

SKU Package List

Get the SKU package list.

API Endpoint

/vcpcloud/api/padApi/getCloudGoodList

Request Method

GET

Request Data Type

application/json

Response Parameters

Parameter Name	Example Value	Type	Description
msg	success	String	Response Message
code	200	Integer	Status Code
data		Object	Response Data
├─ androidVersionName	Android13	String	Android Version Name
├─ cloudGoodsInfo		Object	SKU Package Information
│ ├─ configs		List	Product Model Information
│ │ ├─ configName	Samsung s23 ultra	String	Product Model Name
│ │ ├─ sellOutFlag	false	Boolean	Sold Out Flag
│ │ ├─ configBlurb	Top technology, comparable to real machine supreme experience!	String	Product Model Description
│ │ ├─ defaultSelection	false	Boolean	Default Selection Flag
│ │ ├─ reorder	0	Integer	Sort Order
│ │ ├─ goodTimes		List	Product Price Information
│ │ │ ├─ oldGoodPrice	100	Integer	Original Price
│ │ │ ├─ showContent	1 day	String	Product Duration Name
│ │ │ ├─ whetherFirstPurchase	true	Boolean	First Purchase Flag
│ │ │ ├─ reorder	1	Integer	Sort Order
│ │ │ ├─ goodPrice	100	Integer	Product Price
│ │ │ ├─ equipmentNumber	1	Integer	Product Shipping Equipment Quantity
│ │ │ ├─ goodTime	1440	Integer	Product Duration (Minutes)
│ │ │ ├─ autoRenew	true	Boolean	Supports Auto Renewal
│ │ │ ├─ recommendContent	First purchase special offer	String	Recommended Content
│ │ │ ├─ id	27	Integer	Product ID
ts	1737440589859	Long	Timestamp

Response Example

{
    "msg": "success",
        "code": 200,
        "data": [
        {
            "androidVersionName": "Android13",
            "cloudGoodsInfo": {
                "configs": [
                    {
                        "configName": "Samsung s23 ultra",
                        "sellOutFlag": false,
                        "configBlurb": "顶尖科技，媲美真机至尊体验！",
                        "defaultSelection": false,
                        "reorder": 0,
                        "goodTimes": [
                            {
                                "oldGoodPrice": 100,
                                "showContent": "1天",
                                "whetherFirstPurchase": true,
                                "reorder": 1,
                                "goodPrice": 100,
                                "equipmentNumber": 1,
                                "goodTime": 1440,
                                "autoRenew": true,
                                "recommendContent": "首购特惠",
                                "id": 27
                            }
                        ]
                    }
                ],
                "goodId": 1
            }
        }
    ],
        "ts": 1737440589859
}

Modify Real Machine ADI Template

Modify the cloud real machine ADI template by passing the cloud real machine template ID.

Prerequisites:

The instance must be created as a cloud real machine type.
The instance's specifications must match the target ADI template specifications.
The instance's Android version must match the target ADI Android version.

API Endpoint

/vcpcloud/api/padApi/replaceRealAdiTemplate

Request Method

POST

Request Data Type

application/json

Request BODY Parameters

Parameter Name	Example Value	Parameter Type	Required	Description
padCodes		String[]	Yes	List of instance codes
├─	AC22010020062	String	Yes	Instance Code
wipeData	false	Boolean	Yes	Whether to wipe data
realPhoneTemplateId	186	Long	Yes	Cloud Real Machine Template ID

Response Parameters

Parameter Name	Example Value	Parameter Type	Description
msg	success	String	Response message
code	200	Integer	Status code
data		Object	Response data
├─ taskId	1	Integer	Task ID
├─ padCode	AC21020010001	String	Instance Code
├─ vmStatus	1	Integer	Instance online status (0: offline; 1: online)

Request Example

{
    "padCodes": ["AC32010250011"],
    "wipeData": true,
    "realPhoneTemplateId": 186
}

Response Example

{
    "code": 200,
        "msg": "success",
        "ts": 1736326542985,
        "data": [{
        "taskId": 10074,
        "padCode": "AC32010250011",
        "errorMsg": null
    }]
}

Cloud machine simulated touch

The cloud machine simulates the touch interface. The result can be queried through the Instance operation task details interface.

API Endpoint

/vcpcloud/api/padApi/simulateTouch

Request Method

POST

Request Data Type

application/json

Request BODY Parameters

Parameter Name	Example Value	Parameter Type	Required	Description
padCodes		Object[]	Yes	Instance code that needs to trigger a click
├─ ACP250329MMRFCCT		String	Yes	Pad Code
width	1080	Integer	Yes	Touch container width
height	1920	Integer	Yes	Touch container height
positions		Object[]	Yes	Touch coordinate collection
├─ actionType	1	Integer	Yes	Operation type (0: pressed; 1: lifted; 2: touching)
├─ x	100	float	Yes	x coordinate of click
├─ y	100	float	Yes	y coordinate of click
├─ nextPositionWaitTime	100	Integer	Yes	When there are multiple sets of coordinates, the waiting interval in milliseconds to trigger the next set of click coordinates

Response Example

Parameter Name	Example Value	Parameter Type	Description
msg	success	String	Response message
code	200	Integer	Status code
data		Object	Response data
├─ padCode	ACP250329MMRFCCT	String	PadCode
├─ taskId	10004759	Long	task id
├─ vmStatus	0	Integer	Instance online status (0: offline; 1: online)

Request Example

{
    "padCodes": [
        "ACP250329MMRFCCT"
    ],
    "width": 1080,
    "height": 1920,
    "positions": [
        {
            "actionType": 0,
            "x": 100,
            "y": 100,
            "nextPositionWaitTime": 20
        },
        {
            "actionType": 2,
            "x": 110,
            "y": 110,
            "nextPositionWaitTime": 22
        },
        {
            "actionType": 2,
            "x": 120,
            "y": 120,
            "nextPositionWaitTime": 23
        },
        {
            "actionType": 1,
            "x": 120,
            "y": 120
        }
    ]
}

Response Example

{
    "code": 200,
    "msg": "success",
    "ts": 1743676563784,
    "data": [
        {
            "taskId": 100059,
            "padCode": "ACP250329MMRFCCT",
            "vmStatus": 0
        },
        {
            "taskId": 100060,
            "padCode": "ACP250329MMRFCCT",
            "vmStatus": 0
        }
    ]
}

Android image version collection

Get the image set that can be upgraded on the current device

API Endpoint

/vcpcloud/api/padApi/imageVersionList

Request Method

POST

Request Data Type

application/json

Request BODY Parameters

Parameter Name	Example Value	Parameter Type	Required	Description
padCode	ACP250329MMRFCCT	String	YES	PadCode

Response Parameters

Parameter Name	Example Value	Parameter Type	Description
msg	success	String	response message
code	200	Integer	status code
data		Object[]	Data list
├─ nowImgId	img-25033129396	String	Current device image version ID
├─ hasNewVersion	false	Boolean	Whether there is an image version that can be upgraded.
├─ imageVersionList		Object[]	Image version list
├─├─ imageId	img-25033129396	String	Image version ID
├─├─ version	20250401	Integer	Image version
├─├─ versionName	20250401	String	Image version Name
├─├─ publishType	released	String	Release type: released-stable, beta-latest
├─├─ imageIllustrate	Fixed the issue that the Coffee Meet Begal app cannot activate location services	String	Mirror update instructions
├─├─ romSdkint	14	Integer	Android version Code
├─├─ romSdkName	Android 14	String	Android release notes

Request Example

{
    "padCode": "ACP250329MMRFCCT"
}

Response Example

{
    "msg": "success",
        "code": 200,
        "data": {
        "nowImgId": "img-25033129396",
        "imageManageList": [
            {
                "imageId": "img-25040148674",
                "version": 20250401,
                "versionName": "20250401",
                "publishType": "released",
                "imageIllustrate": "Fixed the issue that the Coffee Meet Begal app cannot activate location services",
                "romSdkint": 34,
                "romSdkName": "Android 14"
            },
            {
                "imageId": "img-25033136513",
                "version": 20250331,
                "versionName": "20250331",
                "publishType": "released",
                "imageIllustrate": "Expand the tool model to add a blacklist",
                "romSdkint": 34,
                "romSdkName": "Android 14"
            },
            {
                "imageId": "img-25040129277",
                "version": 20250401,
                "versionName": "20250401",
                "publishType": "released",
                "imageIllustrate": "termux supports root",
                "romSdkint": 29,
                "romSdkName": "Android 10"
            },
            {
                "imageId": "img-25040872272",
                "version": 30000013,
                "versionName": "30000013",
                "publishType": "beta",
                "imageIllustrate": "B",
                "romSdkint": 33,
                "romSdkName": "Android 13"
            },
            {
                "imageId": "img-25032893685",
                "version": 20250328,
                "versionName": "20250328",
                "publishType": "released",
                "imageIllustrate": "1.tools add language",
                "romSdkint": 33,
                "romSdkName": "Android 13"
            }
        ],
        "hasNewVersion": false
    },
    "ts": 1744181920213
}

Equipment Pre-sale Purchase

When stock is insufficient, you can use this API to pre-order a device (only applicable to cloud phone products with a rental period of 30 days or more). Once stock is replenished, the system will prioritize fulfilling pre-sale orders and automatically dispatch the devices. After the order is shipped, users will receive an email notification and an additional one-day usage bonus.

API Endpoint

/vcpcloud/api/padApi/createMoneyProOrder

Request Method

POST

Request Data Type

application/json

Request BODY Parameters

Parameter Name	Example Value	Parameter Type	Required	Description
androidVersionName	Android13	String	是	Android Version：Android10、Android13、Android14
goodId	1	Integer	是	Product ID (corresponding to the Product ID value of SKU Package List)
goodNum	1	Integer	是	Product Number
autoRenew	true	Boolean	是	Whether to automatically renew (default closed) true-on, false-off

Response Parameters

Parameter Name	Example Value	Parameter Type	Description
msg	success	String	Response message
code	200	Integer	Status code
data	VMOS-CLOUD174290228048631464	String	Pre-sale order number

Request Example

{
    "androidVersionName": "Android13",
    "goodId": 75,
    "goodNum": 1,
    "autoRenew": true
}

Response Example

{
	"msg": "success",
	"code": 200,
	"data": "VMOS-CLOUD174290228048631464",
	"ts": 1736306672346
}

Query pre-sale order result details

Query the details of pre-sale order results. You can query by pre-sale order number, order status (1-to be shipped 2-shipped, empty default all)

API Endpoint

/vcpcloud/api/padApi/queryProOrderList

Request Method

POST

Request Data Type

application/json

Request BODY Parameters

Parameter Name	Example Value	Parameter Type	Required	Description
proBuyStatus	2	Integer	No	1-To be shipped 2-Shipment If empty, default to all
orderId	VMOS-CLOUD174290228048631464	Integer	No	Pre-sale order number

Response Parameters

Parameter Name	Example Value	Parameter Type	Required
msg	success	String	Response message
code	200	Integer	Status code
data		Object[]	Data list
├─ proBuyOrderId	VMOS-CLOUD174290228048631464	String	Pre-sale order number
├─ proBuyStatus	2	Integer	1-To be shipped 2-Shipment
├─ proBuyNumber	1	Integer	Purchase quantity
├─ createTime	2025-03-25 19:31:21	String	creation time
├─ payTime	2025-03-25 19:31:21	String	payment time
├─ endTime	2025-03-25 19:41:33	String	Shipping time
├─ orderPrice	1399	Integer	Order Amount (cents)
├─ goodName	Samsung Galaxy A53	String	Device name
ts	1736306672346	Long	Timestamp

Request Example

{
    "proBuyStatus": "2",
    "orderId": "VMOS-CLOUD174290228048631464"
}

Response Example

{
    "msg": "success",
        "code": 200,
        "data": [
        {
            "proBuyOrderId": "VMOS-CLOUD174290228048631464",
            "proBuyStatus": 2,
            "proBuyNumber": 1,
            "createTime": "2025-03-25 19:31:21",
            "payTime": "2025-03-25 19:31:21",
            "endTime": "2025-03-25 19:41:33",
            "orderPrice": 499,
            "goodName": "V08"
        },
        {
            "proBuyOrderId": "VMOS-CLOUD174323615535421664",
            "proBuyStatus": 2,
            "proBuyNumber": 1,
            "createTime": "2025-03-29 16:16:22",
            "payTime": "2025-03-29 16:16:22",
            "endTime": "2025-03-29 16:18:03",
            "orderPrice": 1399,
            "goodName": "Samsung Galaxy A53"
        }
    ],
        "ts": 1743239203460
}

SDK Token Issuance

Issue a temporary STS Token for user authentication to access the cloud mobile phone service.

Get SDK Temporary Token

API Endpoint

/vcpcloud/api/padApi/stsToken

Request Method

GET

Request Data Type

application/json

Response Parameters

Parameter Name	Example Value	Parameter Type	Description
msg	success	String	Response message
code	200	Integer	Status code
data		Object	Data list
├─ token	18df5803-48ce-4b53-9457-6a15feb1daca	String	SDK communication token

Response Example

{
    "code": 200,
    "msg": "success",
    "ts":1713773577581,
    "data": {
        "token": "18df5803-48ce-4b53-9457-6a15feb1daca"
    }
}

SDK Token Issuance (by padCode)

Issue a temporary STS Token for user authentication to access the cloud mobile phone service (the token can only be used for the specified padCode).

Get SDK Temporary Token by padCode

API Endpoint

/vcpcloud/api/padApi/stsTokenByPadCode

Request Method

POST

Request Data Type

application/json

Request Body Parameters

Parameter Name	Example Value	Parameter Type	Required	Description
padCode	AC32010230001	String	Yes	Instance ID (padCode)

Response Parameters

Parameter Name	Example Value	Parameter Type	Description
msg	success	String	Response message
code	200	Integer	Status code
data		Object	Data list
├─ token	18df5803-48ce-4b53-9457-6a15feb1daca	String	SDK communication token

Request Example

{"padCode":"AC32010230001"}

Response Example

{
    "code": 200,
        "msg": "success",
        "ts":1713773577581,
        "data": {
        "token": "18df5803-48ce-4b53-9457-6a15feb1daca"
    }
}

Clear SDK Authorization Token

API Endpoint

/vcpcloud/api/padApi/clearStsToken

Request Method

POST

Request Data Type

application/json

Request Body Parameters

Parameter Name	Example Value	Parameter Type	Required	Description
token	123	String	Yes	The token to be cleared

Response Parameters

Parameter Name	Example Value	Parameter Type	Description
msg	success	String	Response message
code	200	Integer	Status code
data		Object	Data list

Request Example

{"token":1234}

Response Example

{
    "code": 200,
        "msg": "success",
        "ts":1713773577581,
        "data": null
}

Cloud Space

Query User File List

Endpoint URL

/vcpcloud/api/padApi/selectFiles

Request Method

POST

Request Data Type

application/json

Request Body Parameters

None

Response Parameters

Parameter Name	Example Value	Data Type	Description
code	200	Integer	Status code
msg	success	String	Response message
ts	1756021167163	Long	Timestamp
data		Object[]	Response body
├─appName	Kuaishou Lite	String	File name
├─downloadUrl	https://file.vmoscloud.com/userFile/fd31c45b5a7c3e6249c7d1b1dca6ff77.apk	String	File download link
├─packageName	com.kuaishou.nebula	String	APK package name, only for apk files
├─fileId	479472	Integer	Cloud space file ID

Response Example

{
    "msg": "success",
    "code": 200,
    "data": [
        {
            "appName": "Kuaishou Lite",
            "downloadUrl": "https://file.vmoscloud.com/userFile/fd31c45b5a7c3e6249c7d1b1dca6ff77.apk",
            "packageName": "com.kuaishou.nebula",
            "fileId": 479472
        }
    ],
    "ts": 1746711010676
}

Delete Cloud Space Files

Endpoint URL

/vcpcloud/api/padApi/deleteOssFiles

Request Method

POST

Request Data Type

application/json

Request Body Parameters

Parameter Name	Example Value	Data Type	Required	Description
files		Integer[]	Yes	Collection of unique cloud space file IDs
├─	479452	Integer	Yes	Unique cloud space file ID
urls		String[]	No	Collection of cloud space file download links
├─	479452	String	No	Cloud space file download link

Response Parameters

Parameter Name	Example Value	Data Type	Description
code	200	Integer	Status code
msg	success	String	Response message
ts	1756021167163	Long	Timestamp

Request Example

{
    "files": [479452]
}

Response Example

{
    "msg": "success",
    "code": 200,
    "ts": 1746694236404
}

Upload File to Cloud Space

Upload file to cloud space and get download link

Endpoint URL

/vcpcloud/api/padApi/uploadFile

Request Method

POST

Request Data Type

multipart/form-data

body Note: it is form, not json

Request form-data Parameters

Parameter Name	Example Value	Data Type	Required	Description
file	FourSeasonsPhilly.webp	File	Yes	File to upload

Response Parameters

Parameter Name	Example Value	Data Type	Description
code	200	Integer	Status code
msg	success	String	Response message
ts	1756021167163	Long	Timestamp
data		Object	Response body
├─downloadUrl	https://file.vmoscloud.com/userFile/83bb260163f78e6928c1fe5acda.webp	String	File download link

Request Example

curl --request POST \
  --url /vcpcloud/api/padApi/uploadFile \
  --header 'accept-language: zh' \
  --header 'content-type: multipart/form-data' \
  --form 'file=@C:\FourSeasonsPhilly.webp'

Response Example

{
    "msg": "success",
    "code": 200,
    "data": {
        "downloadUrl": "https://file.vmoscloud.com/userFile/83bb260163f78e6928c1fe5acda.webp"
    },
    "ts": 1746704760360
}

Purchase Cloud Space Expansion

Purchase cloud space expansion

Endpoint URL

/vcpcloud/api/padApi/buyStorageGoods

Request Method

POST

Request Data Type

application/json

Request Body Parameters

Parameter Name	Example Value	Data Type	Required	Description
storageId	1	Integer	Yes	Unique ID of cloud space expansion product
autoRenewOrder	0	Integer	Yes	Auto-renew? 0-No 1-Yes

Response Parameters

Parameter Name	Example Value	Data Type	Description
msg	success	String	Response message
code	200	Integer	Status code
ts	1745569714501	Long	Execution Timestamp

Request Example

{
    "storageId": 1,
    "autoRenewOrder": 0
}

Response Example

{
    "msg": "success",
    "code": 200,
    "ts": 1745569714501
}

Storage Resource Package List

List of storage resource packages after shutdown backup

Endpoint URL

/vcpcloud/api/padApi/vcTimingBackupList

Request Method

GET

Request Data Type

application/json

Request Query Parameters

None

Response Parameters

Parameter Name	Example Value	Data Type	Description
msg	success	String	Response message
code	200	Integer	Status code
data		Object[]	Resource package collection info
├─ backupId	ZSC250425LIOJY2V-ACN250424VU2F6LB	String	Backup resource package ID
├─ padCode	ACN250424VU2F6LB	String	Device belonging to the backup package
├─ beginTime	2025-04-25 16:28:48	String	Backup time
├─ remark	Time:20250425162833	String	Backup description. If a remark is passed during backup, the custom one is used; otherwise, the default is the backup time
├─ padName	V06	String	Custom device name, used to quickly distinguish and find resource packages

Response Example

{
    "msg": "success",
    "code": 200,
    "data": [
        {
            "backupId": "ZSC250425LIOJY2V-ACN250424VU2F6LB",
            "padCode": "ACN250424VU2F6LB",
            "beginTime": "2025-04-25 16:28:48",
            "remark": "Time:20250425162833",
            "padName": "V06"
        }
    ],
    "ts": 1745570858994
}

Cloud Space Product List

Cloud space product list

Endpoint URL

/vcpcloud/api/padApi/getVcStorageGoods

Request Method

GET

Request Data Type

application/json

Request Query Parameters

None

Response Parameters

Parameter Name	Example Value	Data Type	Description
msg	success	String	Response message
code	200	Integer	Status code
data		Object[]	Resource package collection info
├─ oldPrice	169	Long	Original price
├─ payPrice	169	Long	Sales price after discount
├─ subscriptTips	15% off	String	Discount description
├─ useTime	43200	Long	Valid minutes
├─ storageCapacity	107374182400	Long	Corresponding cloud space size
├─ storageId	1	Integer	Cloud space product unique ID
├─ storageName	100GB/Month	String	Cloud space product description

Response Example

{
    "msg": "success",
        "code": 200,
        "data": [
            {
                "oldPrice": 199,
                "payPrice": 169,
                "subscriptTips": "15% off",
                "useTime": 43200,
                "reorder": 1,
                "storageCapacity": 107374182400,
                "selected": true,
                "storageId": 1,
                "storageName": "100GB/Month"
            }
        ],
        "ts": 1745572789763
}

Aggregate Renewal of Cloud Space Products

Aggregate renewal of cloud space products

Endpoint URL

/vcpcloud/api/padApi/renewsStorageGoods

Request Method

POST

Request Data Type

application/json

Request Body Parameters

Parameter Name	Example Value	Data Type	Required	Description
autoRenewOrder	0	Integer	Yes	Auto-renew? 0-No 1-Yes

Response Parameters

Parameter Name	Example Value	Data Type	Description
msg	success	String	Response message
code	200	Integer	Status code
ts	1745569714501	Long	Execution Timestamp

Request Example

{
    "autoRenewOrder": 0
}

Response Example

{
    "msg": "success",
    "code": 200,
    "ts": 1745569714501
}

Delete Backup Resource Package Data

Delete backup resource package data

Endpoint URL

/vcpcloud/api/padApi/deleteUploadFiles

Request Method

POST

Request Data Type

application/json

Request Body Parameters

Parameter Name	Example Value	Data Type	Required	Description
		String[]	Yes	Collection of resource package IDs to delete
├─	ZSC250425LIOJY2V-ACN250424VU2F6LB	String	Yes	Resource package ID to delete

Response Parameters

Parameter Name	Example Value	Data Type	Description
msg	success	String	Response message
code	200	Integer	Status code
ts	1745569714501	Long	Execution Timestamp

Request Example

[
    "ZSC250425LIOJY2V-ACN250424VU2F6LB"
]

Response Example

{
    "msg": "success",
    "code": 200,
    "ts": 1745569714501
}

Cloud Space Auto-renew Aggregate Product Switch

Cloud space auto-renew aggregate product switch

Endpoint URL

/vcpcloud/api/padApi/updateRenewStorageStatus

Request Method

GET

Request Data Type

application/json

Request Query Parameters

Parameter Name	Example Value	Data Type	Required	Description
renewStorageStatus	false	String	Yes	Auto-renew? false-No true-Yes

Response Parameters

Parameter Name	Example Value	Data Type	Description
msg	success	String	Response message
code	200	Integer	Status code
ts	1745569714501	Long	Execution Timestamp

Request Example

/vcpcloud/api/padApi/updateRenewStorageStatus?renewStorageStatus=false

Response Example

{
    "msg": "success",
    "code": 200,
    "ts": 1745569714501
}

Query Cloud Space Renewal Details

Query cloud space renewal details

Endpoint URL

/vcpcloud/api/padApi/selectAutoRenew

Request Method

GET

Request Data Type

application/json

Request Query Parameters

None

Response Parameters

Parameter Name	Example Value	Data Type	Description
msg	success	String	Response message
code	200	Integer	Status code
data		Object[]	Renewal information
├─ renewStorageStatus	0	Integer	Whether auto-renew is enabled 0-No 1-Yes
├─ storageSize	214748364800	Long	Total size of renewed cloud space
├─ storageAmount	338	Long	Renewal amount required (cents)
├─ signExpirationTime	2025-05-10 19:22:35	String	Expiration Time

Response Example

{
    "msg": "success",
    "code": 200,
    "data": {
        "renewStorageStatus": 0,
        "storageSize": 214748364800,
        "storageAmount": 338,
        "signExpirationTime": "2025-05-10 19:22:35"
    },
    "ts": 1745573906608
}

Cloud Space Remaining Storage Capacity

Cloud space remaining storage capacity

Endpoint URL

/vcpcloud/api/padApi/getRenewStorageInfo

Request Method

GET

Request Data Type

application/json

Request Query Parameters

None

Response Parameters

Parameter Name	Example Value	Data Type	Description
msg	success	String	Response message
code	200	Integer	Status code
data		Object	Resource package collection info
├─ accountBalance	100	Long	Wallet balance (cents)
├─ storageCapacityLimit	112742891520	Long	Available space size 1GB = 1024 x 1024 x 1024 Byte
├─ storageUsedAvail	17325201433	Long	Used space size
├─ other		Object	Additional space details
├─├─ signExpirationTime	2025-05-10 19:22:35	String	Additional space expiration time
├─├─ storageAmount	169	Long	Renewal amount required for additional space (cents)
├─├─ otherStorageSize	107374182400	Long	Additional space size

Response Example

{
    "msg": "success",
    "code": 200,
    "data": {
        "accountBalance": 100,
        "storageCapacityLimit": 112742891520,
        "storageUsedAvail": 17325201433,
        "other": {
            "signExpirationTime": "2025-05-10 19:22:35",
            "storageAmount": 169,
            "otherStorageSize": 107374182400
        }
    },
    "ts": 1745571643583
}

Static Residential Service

Get Static Residential Product List

Endpoint URL

/vcpcloud/api/padApi/proxyGoodList

Request Method

GET

Request Data Type

application/json

Request Query Parameters

None

Response Parameters

Parameter Name	Example Value	Data Type	Description
msg	success	String	Response message
code	200	Integer	Status code
ts	1736922808949	Integer	Timestamp
data		Object[]	Status code
├─proxyGoodName	5 days	String	Product Name
├─proxyGoodId	1	Integer	Unique Product ID
├─proxyGoodPrice	200	Integer	Product price (cents)
├─proxyGoodType	2	Integer	Proxy product type: 0-General 1-socket5 2-http 3-https
├─proxyGoodTime	7200	Integer	Product duration (minutes)

Response Example

{
    "msg": "success",
    "code": 200,
    "data": [
        {
            "proxyGoodName": "5 days",
            "proxyGoodId": 4,
            "proxyGoodTime": 7200,
            "proxyGoodType": 2,
            "proxyGoodPrice": 200
        }
    ],
    "ts": 1747734076860
}

Get Supported Countries/Cities for Static Residential Products

Endpoint URL

/vcpcloud/api/padApi/getProxyRegion

Request Method

GET

Request Data Type

application/json

Request Query Parameters

None

Response Parameters

Parameter Name	Example Value	Data Type	Description
msg	success	String	Response message
code	200	Integer	Status code
ts	1736922808949	Integer	Timestamp
data		Object[]
├─country	cn	String	Supported country code
├─countryZh	China	String	Supported country description
├─countryId	15	Integer	Unique country ID

Response Example

{
    "msg": "success",
    "code": 200,
    "data": [
        {
            "country": "cn",
            "countryZh": "China",
            "countryId": 15
        },
    ],
    "ts": 1747734076860
}

Purchase Static Residential Product

Endpoint URL

/vcpcloud/api/padApi/createProxyOrder

Request Method

POST

Request Data Type

application/json

Request Body Parameters

Parameter Name	Example Value	Data Type	Description
proxyGoodId	4	Integer	Unique ID of the corresponding static residential product
region	cn	String	Region of static residential proxy-country
num	1	Integer	Purchase quantity
country	cn	String	Country of static residential proxy-country
proxyAddress	China	String	Address of static residential proxy-countryZh
autoRenew	true	Boolean	Enable auto-renew false-off true-on

Response Parameters

Parameter Name	Example Value	Data Type	Description
msg	success	String	Response message
code	200	Integer	Status code
ts	1736922808949	Integer	Timestamp

Request Example

{
    "proxyGoodId": 4,
    "region": "cn",
    "num": 1,
    "country": "cn",
    "proxyAddress": "China",
    "autoRenew": true
}

Response Example

{
    "msg": "success",
    "code": 200,
    "ts": 1745823575860
}

Static Residential Proxy Order Details

Endpoint URL

/vcpcloud/api/padApi/selectProxyOrderList

Request Method

POST

Request Data Type

application/json

Request Body Parameters

Parameter Name	Example Value	Data Type	Description
page	1	Integer	Page number
rows	10	Integer	Items per page

Response Parameters

Parameter Name	Example Value	Data Type	Description
msg	success	String	Response message
code	200	Integer	Status code
ts	1736922808949	Integer	Timestamp
data		Object
├─total	1	Integer	Total count
├─size	10	Integer	Number of items per page
├─pages	1	Integer	Total pages
├─records		Object[]	Order information
├─├─buyNumber	1	String	Purchase quantity
├─├─goodName	New Purchase5-day agency product	String	Product name
├─├─createTime	1747734544000	Long	Creation time
├─├─orderId	VMOS-CLOUD174773454378660285	String	Order ID
├─├─payPrice	200	String	Payment amount
├─├─orderStatus	vpn	String	Order status 0-unpaid 1-paid
├─├─orderPrice	cn	String	Order amount
├─├─goodPrice	Sichuan	String	Unit price
├─├─goodNum	Sichuan	String	Product quantity

Request Example

{
    "page": 1,
    "rows": 10
}

Response Example

{
    "msg": "success",
    "code": 200,
    "data": {
        "current": 1,
        "total": 30,
        "pages": 3,
        "size": 10,
        "records": [
            {
                "buyNumber": 1,
                "goodName": "New Purchase5-day agency product",
                "createTime": 1747734544000,
                "orderId": "VMOS-CLOUD174773454378660285",
                "payPrice": 200,
                "orderStatus": 1,
                "orderPrice": 200,
                "goodPrice": 200,
                "goodNum": 1
            }
        ]
    },
    "ts": 1747734706973
}

Static Residential Proxy Renewal

Endpoint URL

/vcpcloud/api/padApi/createRenewProxyOrder

Request Method

POST

Request Data Type

application/json

Request Body Parameters

Parameter Name	Example Value	Data Type	Description
proxyGoodId	4	Integer	Unique ID of the corresponding static residential product
proxyIps	154.81.41.161,154.81.41.162	String	IPs to renew, separated by commas
autoRenew	true	Boolean	Enable auto-renew false-off true-on

Response Parameters

Parameter Name	Example Value	Data Type	Description
msg	success	String	Response message
code	200	Integer	Status code
ts	1736922808949	Integer	Timestamp

Request Example

{
    "proxyGoodId": 4,
    "proxyIps": "154.81.41.161,154.81.41.162",
    "autoRenew": true
}

Response Example

{
    "msg": "success",
    "code": 200,
    "ts": 1745823575860
}

Query Static Residential Proxy List

Endpoint URL

/vcpcloud/api/padApi/queryProxyList

Request Method

POST

Request Data Type

application/json

Request Body Parameters

Parameter Name	Example Value	Data Type	Description
current	1	Integer	Page number
size	10	Integer	Items per page

Response Parameters

Parameter Name	Example Value	Data Type	Description
msg	success	String	Response message
code	200	Integer	Status code
ts	1736922808949	Integer	Timestamp
data		Object
├─total	1	Integer	Total count
├─size	10	Integer	Number of items per page
├─pages	1	Integer	Total pages
├─records		Object[]	Order information
├─├─proxyStatus	1	Integer	Proxy status: 0-checking 1-normal -1-check failed 2-pending check
├─├─proxyGoodId	4	String	Product ID
├─├─proxyName	154.81.40.200	Long	Proxy name
├─├─proxyUseNumber	0	String	Number of mounted cloud phones
├─├─proxyType	1	String	Proxy type: 1-Socks5 2-http 3-https
├─├─proxyHost	154.81.40.200	String	Order status 0-unpaid 1-paid
├─├─proxyPort	63007	String	Proxy port (odd-socks5 even-http) 63007 (63008)
├─├─password	xxxxxx	String	Proxy password
├─├─proxyCountry	CN	String	Proxy country
├─├─expectedExpireTime	1748166543	String	Expiration timestamp
├─├─expireTime	1748166543	String	Expiration timestamp (same as above, use expireTime)
├─├─account	xxxxxx	String	Username
├─├─proxyId	86930	String	Proxy unique ID (used for mounting cloud phone)

Request Example

{
    "current": 1,
    "size": 10
}

Response Example

{
    "msg": "success",
    "code": 200,
    "data": {
        "current": 1,
        "total": 30,
        "pages": 3,
        "size": 10,
        "records": [
            {
                "proxyStatus": 2,
                "proxyGoodId": 4,
                "proxyName": "154.81.40.200",
                "proxyUseNumber": 0,
                "proxyType": 1,
                "proxyHost": "154.81.40.200",
                "proxyPort": 63007,
                "password": "xxxxxx",
                "proxyCountry": "CN",
                "expireTime": 1748166543,
                "expectedExpireTime": 1748166543,
                "account": "xxxxxxx",
                "proxyId": 86930
            },
        ]
    },
    "ts": 1747734706973
}

Dynamic Proxy Service

Query Dynamic Proxy Product List

Endpoint URL

/vcpcloud/api/padApi/getDynamicGoodService

Request Method

GET

Request Data Type

application/json

Request Query Parameters

None

Response Parameters

Parameter Name	Example Value	Data Type	Description
msg	success	String	Response message
code	200	Integer	Status code
ts	1736922808949	Integer	Timestamp
data		Object[]	Status code
├─goodName	2GB	String	Product Name
├─goodId	1	Integer	Product unique ID
├─goodPrice	1	String	Product price
├─protocolDescription	Github	String	Supported protocol info
├─totalTraffic		Object[]	Traffic package size

Response Example

{
    "msg": "success",
    "code": 200,
    "data": [
        {
            "goodName": "2GB",
            "goodId": 1,
            "goodPrice": 1000,
            "protocolDescription": "HTTP(S)/SOCKS5",
            "totalTraffic": 2048
        }
    ],
    "ts": 1740643153803
}

Query Dynamic Proxy Region List

Endpoint URL

/vcpcloud/api/padApi/getDynamicProxyRegion

Request Method

GET

Request Data Type

application/json

Request Query Parameters

None

Response Parameters

Parameter Name	Example Value	Data Type	Description
msg	success	String	Response message
code	200	Integer	Status code
ts	1736922808949	Integer	Timestamp
data		Object[]	Status code
├─CountryName	United Arab Emirates	String	Country Name
├─CountryCode	AE	String	Country Code
├─State		Object[]	Region list
├─├─city		Object[]	City list
├─├─├─	Musaffahcity	String	City name
├─├─name	Abudhabi	String	Region name

Response Example

{
    "msg": "success",
    "code": 200,
    "data": [
        {
            "CountryName": "United Arab Emirates",
            "CountryCode": "AE",
            "State": [
                {
                    "city": [
                        "Musaffahcity",
                        "Abudhabi"
                    ],
                    "name": "Abudhabi"
                },
            ],
        }
    ],
    "ts": 1740643153803
}

Get Dynamic Proxy Current Balance

Endpoint URL

/vcpcloud/api/padApi/queryCurrentTrafficBalance

Request Method

GET

Request Data Type

application/json

Request Query Parameters

None

Response Parameters

Parameter Name	Example Value	Data Type	Description
msg	success	String	Response message
code	200	Integer	Status code
ts	1736922808949	Integer	Timestamp
data		Object[]	Status code
├─accumulatedTraffic	2048	String	Total traffic
├─remainingTraffic	1024	Object[]	Remaining traffic
├─useTraffic	1024	Object[]	Used traffic

Response Example

{
    "msg": "success",
    "code": 200,
    "data": {
        "accumulatedTraffic": 2048,
        "remainingTraffic": 1024,
        "useTraffic": 1024
    },
    "ts": 1740659529379
}

Query Supported Server Regions

Endpoint URL

/vcpcloud/api/padApi/getDynamicProxyHost

Request Method

GET

Request Data Type

application/json

Request Query Parameters

None

Response Parameters

Parameter Name	Example Value	Data Type	Description
msg	success	String	Response message
code	200	Integer	Status code
ts	1736922808949	Integer	Timestamp
data		Object[]	Status code
├─name	America Region (South America & North America)	String	Continent Name
├─value	xxxxxxx:1234	String	Continent Server Address

Response Example

{
    "msg": "success",
    "code": 200,
    "data": [
        {
            "name": "America Region (South America & North America)",
            "value": "xxxxxxx:1234"
        }
    ],
        "ts": 1740660551742
}

Purchase Dynamic Proxy Traffic Package

Endpoint URL

/vcpcloud/api/padApi/buyDynamicProxy

Request Method

POST

Request Data Type

application/json

Request Body Parameters

Parameter Name	Example Value	Data Type	Description
goodId	1	Integer	Unique ID of the corresponding dynamic traffic package
goodNum	1	Integer	Purchase quantity
autoRenewOrder	1	Integer	Enable auto-renew 0-off 1-on. When remaining traffic is less than 50MB, auto-renew is triggered

Response Parameters

Parameter Name	Example Value	Data Type	Description
msg	success	String	Response message
code	200	Integer	Status code
ts	1736922808949	Integer	Timestamp

Request Example

{
    "goodId": 1,
    "goodNum": 1,
    "autoRenewOrder": 0
}

Response Example

{
    "msg": "success",
    "code": 200,
    "ts": 1745823575860
}

Create Dynamic Proxy

Endpoint URL

/vcpcloud/api/padApi/createProxy

Request Method

POST

Request Data Type

application/json

Request Body Parameters

Parameter Name	Example Value	Data Type	Description
city	""	String	City, pass "" if not selected
countryCode	AE	String	Country Code
goodNum	1	Integer	Purchase quantity
proxyHost	xxxxx:7778	String	Continent website
proxyType	socks5	String	Proxy type socks5 / http / https
proxyUseType	proxy	String	Mount type proxy / vpm
state	Abudhabi	String	Region, pass "" if not selected
time	1	String	Auto change ip frequency (minutes) Options: 5, 10, 15, 30, 45, 60, 90

Response Parameters

Parameter Name	Example Value	Data Type	Description
msg	success	String	Response message
code	200	Integer	Status code
ts	1736922808949	Integer	Timestamp
data		Object	Response body
├─id	82750	Integer	Proxy ID
├─proxyHost		String	Dynamic proxy

Request Example

{
    "proxyHost": "xxxxx:7778",
    "countryCode": "CN",
    "state": "Sichuan",
    "city": "Sichuan",
    "time": 5,
    "proxyType": "socks5",
    "proxyUseType": "vpn"
}

Response Example

{
    "msg": "success",
    "code": 200,
    "data": [
        {
            "id": 82750,
            "proxyHost": "E44S5YaWP660_custom_zone_HK_st_Kowloon_city_sid_27165697_time_10"
        }
    ],
    "ts": 1760068573317
}

Query Dynamic Proxy List (Supports Pagination)

Endpoint URL

/vcpcloud/api/padApi/getProxys

Request Method

GET

Request Data Type

application/json

Request Query Parameters

Parameter Name	Example Value	Data Type	Description
page	1	Integer	Current page
rows	10	Integer	Items per page

Response Parameters

Parameter Name	Example Value	Data Type	Description
msg	success	String	Response message
code	200	Integer	Status code
ts	1736922808949	Integer	Timestamp
data		Object	Status code
├─records		Object[]	Dynamic proxy information
├─├─id	1	String	Unique proxy ID
├─├─proxyHost	xxxxxxx	String	Continent server domain
├─├─proxyPort	1234	String	Continent server port
├─├─userName	E44S5YaWP660_time_5	String	Dynamic proxy username
├─├─password	1234	String	Dynamic proxy password
├─├─proxyType	socks5	String	Dynamic proxy protocol type
├─├─proxyUseType	vpn	String	Dynamic proxy mount type
├─├─countryCode	cn	String	Country Code
├─├─state	Sichuan	String	Region
├─├─city	Sichuan	String	City
├─├─time	5	Integer	Refresh frequency
├─total	1	Integer	Proxy count
├─size	10	Integer	Items per page
├─pages	1	Integer	Total pages

Response Example

{
    "msg": "success",
        "code": 200,
        "data": {
        "records": [
            {
                "id": 1,
                "proxyHost": "xxxxxx",
                "proxyPort": 7778,
                "userName": "E44S5YaW",
                "password": "1111",
                "proxyType": "socks5",
                "proxyUseType": "vpn",
                "countryCode": "cn",
                "state": "Sichuan",
                "city": "Sichuan",
                "time": 5
            }
        ],
        "total": 2,
        "size": 10,
        "current": 1,
        "pages": 1
    },
    "ts": 1740725704758
}

Query Dynamic Proxy Order List (Supports Pagination)

Endpoint URL

/vcpcloud/api/padApi/getDynamicProxyOrders

Request Method

POST

Request Data Type

application/json

Request Body Parameters

Parameter Name	Example Value	Data Type	Description
page	1	Integer	Current page
rows	10	Integer	Items per page
completeStartTime	2025-02-27 23:20:36	String	Payment start time
completeEndTime	2025-02-28 23:20:36	String	Payment end time

Response Parameters

Parameter Name	Example Value	Data Type	Description
msg	success	String	Response message
code	200	Integer	Status code
ts	1736922808949	Integer	Timestamp
data		Object	Status code
├─records		Object[]	Dynamic proxy info
├─├─orderId	VMOS-CLOUD174066963648092563	String	Platform unique ID
├─├─orderPrice	1000	Integer	Order amount in cents
├─├─payPrice	1000	Integer	Payment amount in cents
├─├─createTime	2025-02-27T23:20:36.000+0800	String	Create Time
├─├─completeTime	2025-02-27T23:20:36.000+0800	String	Payment Time
├─├─orderStatus	1	Integer	Order status 0-unpaid 1-paid
├─├─goodId	1	Integer	Product unique ID
├─├─goodNum	1	Integer	Purchase quantity
├─├─goodName	2GB	String	Product Name
├─├─goodPrice	1000	Integer	Product unit price
├─├─goodSize	2048	Integer	Product traffic package size
├─├─sumSize	2048	Integer	Total order traffic package size
├─├─orderOtherInfo	Purchase 2GB traffic package, purchase quantity: 1	String	Order description
├─├─autoRenewOrder	1	Integer	Whether to enable renewal 1-on 0-off (Globally effective)
├─total	1	Integer	Proxy count
├─size	10	Integer	Items per page
├─pages	1	Integer	Total pages

Request Example

{
   "page": 1,
   "rows": 10,
   "completeStartTime": "2025-02-27 23:20:36",
   "completeEndTime": "2025-02-28 23:20:36"
}

Response Example

{
    "msg": "success",
    "code": 200,
    "data": {
    "records": [
            {
                "orderId": "VMOS-CLOUD174066963648092563",
                "orderPrice": 1000,
                "payPrice": 1000,
                "createTime": "2025-02-27T23:20:36.000+0800",
                "completeTime": "2025-02-27T23:20:36.000+0800",
                "orderStatus": 1,
                "goodId": 1,
                "goodNum": 1,
                "goodName": "2GB",
                "goodPrice": 1000,
                "goodSize": 2048,
                "sumSize": 2048,
                "orderOtherInfo": "Purchase 2GB traffic package, purchase quantity: 1",
                "autoRenewOrder": 0
            }
        ],
        "total": 2,
        "size": 10,
        "current": 1,
        "pages": 1
    },
    "ts": 1740726141853
}

Create Dynamic Proxy

Endpoint URL

/vcpcloud/api/padApi/createProxy

Request Method

POST

Request Data Type

application/json

Request Body Parameters

Parameter Name	Example Value	Data Type	Description
city	""	String	City, pass "" if not selected
countryCode	AE	String	Country Code
goodNum	1	Integer	Purchase quantity
proxyHost	xxxxx:7778	String	Continent website
proxyType	socks5	String	Proxy type socks5 / http / https
proxyUseType	proxy	String	Mount type proxy / vpm
state	Abudhabi	String	Region, pass "" if not selected
time	1	String	Auto change ip frequency (minutes) Options: 5, 10, 15, 30, 45, 60, 90

Response Parameters

Parameter Name	Example Value	Data Type	Description
msg	success	String	Response message
code	200	Integer	Status code
ts	1736922808949	Integer	Timestamp

Request Example

{
    "proxyHost": "xxxxx:7778",
    "countryCode": "CN",
    "state": "Sichuan",
    "city": "Sichuan",
    "time": 5,
    "proxyType": "socks5",
    "proxyUseType": "vpn"
}

Response Example

{
    "msg": "success",
    "code": 200,
    "ts": 1745823575860
}

Configure Dynamic Proxy for Cloud Phone

Endpoint URL

/vcpcloud/api/padApi/batchPadConfigProxy

Request Method

POST

Request Data Type

application/json

Request Body Parameters

Parameter Name	Example Value	Data Type	Description
padCodes		String[]	Cloud phone collection
├─	AC32010921223	String	Cloud phone number
setProxyFlag	true	Boolean	Whether device proxies to cloud phone
proxyIds	[ 82750 ]	Array	Dynamic Proxy unique ID

Response Parameters

Parameter Name	Example Value	Data Type	Description
msg	success	String	Response message
code	200	Integer	Status code
ts	1736922808949	Integer	Timestamp
data	1cb0ba24-cdc2-47d3-909d-d7ea2ab10576	String	Batch ID

Request Example

{
    "padCodes": [
        "AC32010921223"
    ],
    "setProxyFlag": true,
    "proxyIds":  [
        82750
    ]
}

Response Example

{
    "msg": "success",
    "code": 200,
    "ts": 1745823575860,
    "data": "1cb0ba24-cdc2-47d3-909d-d7ea2ab10576"
}

Query Batch Cloud Phone Proxy Setting Task

Endpoint URL

/vcpcloud/api/padApi/selectBatchPadProxyTask

Request Method

POST

Request Data Type

application/json

Request Body Parameters

Parameter Name	Example Value	Data Type	Description
taskId	1cb0ba24-cdc2-47d3-909d-d7ea2ab10576	Integer	Batch ID, mounting proxy is an asynchronous operation, so need to wait 5s or loop query

Response Parameters

Parameter Name	Example Value	Data Type	Description
msg	success	String	Response message
code	200	Integer	Status code
ts	1736922808949	Integer	Timestamp
data	[]	Array	Batch ID
├─padCode	ACP250317BH33TR6	String	Device number
├─taskId	994365372	Long	Task ID, query result via cloud phone task

Request Example

{
    "taskId": "1cb0ba24-cdc2-47d3-909d-d7ea2ab10576"
}

Response Example

{
    "msg": "success",
    "code": 200,
    "data": [
        {
            "padCode": "ACP250317BH33TR6",
            "taskId": 994365372
        }
    ],
    "ts": 1760102034102
}

Query Dynamic Proxy Auto-Renew Information

Endpoint URL

/vcpcloud/api/padApi/getDynamicProxyAutomaticRenewal

Request Method

GET

Request Data Type

application/json

Request Query Parameters

None

Response Parameters

Parameter Name	Example Value	Data Type	Description
msg	success	String	Response message
code	200	Integer	Status code
ts	1736922808949	Integer	Timestamp
data		Object[]	Status code
├─good_size	2048	Integer	Renewal traffic package size
├─auto_renew_order	1	Integer	Whether auto-renew is enabled 0-off 1-on
├─order_price	199	Integer	Amount to be deducted for auto-renew
├─good_name	Traffic package	String	Auto-renew product name
├─good_number	1	Integer	Auto-renew product quantity

Response Example

{
    "msg": "success",
    "code": 200,
    "data": [
        {
            "good_size": 2048,
            "auto_renew_order": 1,
            "order_price": 199,
            "good_name": "Traffic package",
            "good_number": 1
        }
    ],
    "ts": 1745308893191
}

Set Dynamic Proxy Auto-Renew Switch

Endpoint URL

/vcpcloud/api/padApi/setAutoRenewSwitch

Request Method

POST

Request Data Type

application/json

Request Body Parameters

Parameter Name	Example Value	Data Type	Description
autoRenewOrder	0	Integer	Auto-renew switch 0-off 1-on

Response Parameters

Parameter Name	Example Value	Data Type	Description
msg	success	String	Response message
code	200	Integer	Status code
ts	1736922808949	Integer	Timestamp

Request Example

{
    "autoRenewOrder": 0
}

Response Example

{
    "msg": "success",
    "code": 200,
    "ts": 1745823575860
}

Delete Dynamic Proxy

Endpoint URL

/vcpcloud/api/padApi/delProxyByIds

Request Method

POST

Request Data Type

application/json

Request Body Parameters

Parameter Name	Example Value	Data Type	Description
ids		Integer[]	Collection of dynamic proxy IDs to delete
├─	1	Integer	Dynamic proxy unique ID

Response Parameters

Parameter Name	Example Value	Data Type	Description
msg	success	String	Response message
code	200	Integer	Status code
ts	1736922808949	Integer	Timestamp

Request Example

{
    "ids": [
        1
    ]
}

Response Example

{
    "msg": "success",
    "code": 200,
    "ts": 1745823575860
}

Email Verification Service

Purchase email and get verification codes for related services

Get Email Service List

Endpoint URL

/vcpcloud/api/padApi/getEmailServiceList

Request Method

GET

Request Data Type

application/json

Request Query Parameters

None

Response Parameters

Parameter Name	Example Value	Data Type	Description
msg	success	String	Response message
code	200	Integer	Status code
ts	1736922808949	Integer	Timestamp
data		Object[]	Status code
├─price	0.01	Float	Price
├─stockNum	300	Integer	Remaining stock
├─serviceId	1	String	Service list ID
├─serviceName	Github	String	Service name
├─items		Object[]	Sub-service list
├─├─serviceItemId	1	Integer	Sub-service unique ID (ID used when purchasing)
├─├─serviceItemName	Github Register	String	Sub-service name

Response Example

{
    "msg": "success",
    "code": 200,
    "data": [
        {
            "price": 0.01,
            "stockNum": 300,
            "serviceId": 1,
            "serviceName": "Github",
            "items": [
                {
                    "serviceItemId": 1,
                    "serviceItemName": "Github Register"
                }
            ]
        }
    ],
    "ts": 1745825162018
}

Get Email Type and Remaining Stock

Endpoint URL

/vcpcloud/api/padApi/getEmailTypeList

Request Method

GET

Request Data Type

application/json

Request Query Parameters

Parameter Name	Example Value	Data Type	Description
serviceId	1	Integer	Corresponds to serviceItemId field

Response Parameters

Parameter Name	Example Value	Data Type	Description
msg	success	String	Response message
code	200	Integer	Status code
ts	1736922808949	Integer	Timestamp
data		Object[]	Status code
├─price	0.01	Float	Price
├─name	Outlook	String	Type name
├─stockNum	630	Integer	Remaining stock
├─id	1	Integer	Email type ID

Request Example

{
    "serviceId": "1"
}

Response Example

{
    "msg": "success",
    "code": 200,
    "data": [
        {
            "price": 0.01,
            "name": "Outlook",
            "stockNum": 300,
            "id": 1
        }
    ],
    "ts": 1745823575860
}

Create Email Purchase Order

Endpoint URL

/vcpcloud/api/padApi/getEmailTypeList

Request Method

POST

Request Data Type

application/json

Request Body Parameters

Parameter Name	Example Value	Data Type	Description
serviceId	1	Integer	Corresponds to serviceItemId field
emailTypeId	1	Integer	Corresponds to ID field returned by /getEmailTypeList
goodNum	1	Integer	Purchase quantity

Response Parameters

Parameter Name	Example Value	Data Type	Description
msg	success	String	Response message
code	200	Integer	Status code
ts	1736922808949	Integer	Timestamp

Request Example

{
    "serviceId": 1,
    "emailTypeId": 1,
    "goodNum": 1
}

Response Example

{
    "msg": "success",
    "code": 200,
    "ts": 1745823575860
}

Query Purchased Email List

When the verification code cannot be obtained through the refresh interface, you can query the result through: https://api.vmoscloud.com/vcpcloud/api/padApi/code?orderId= + outOrderId (external order number)

Endpoint URL

/vcpcloud/api/padApi/getEmailOrder

Request Method

GET

Request Data Type

application/json

Request Body Parameters

Parameter Name	Example Value	Data Type	Description
page	1	Integer	Required, pagination parameter, current page
size	10	Integer	Required, pagination parameter, items per page
serviceId	1	Integer	Optional, corresponds to serviceItemId field
email	yzxovmq	String	Optional, email fuzzy query
status	0	Integer	Optional, email status 0-unused 1-receiving 2-used 3-expired

Response Parameters

Parameter Name	Example Value	Data Type	Description
msg	success	String	Response message
code	200	Integer	Status code
ts	1745835489149	Long	Timestamp (milliseconds)
data		Object	Data object
├─ current	1	Integer	Current page number
├─ total	1	Integer	Total records
├─ pages	1	Integer	Total pages
├─ size	10	Integer	Page size
├─ records		Object[]	Data record list
├─├─ id	1	Long	Primary key ID
├─├─ userId	10667	Long	User ID
├─├─ email	yzxovmqi828@outlook.com	String	Email address
├─├─ emailStatus	0	Integer	Email status (0-unused)
├─├─ emailTypeId	1	Integer	Email type ID
├─├─ emailTypeName	Outlook	String	Email type name
├─├─ emailServiceId	2	Integer	Email service provider ID
├─├─ emailServiceName	Apple	String	Email service provider name
├─├─ emailCode	767170	String	Email verification code
├─├─ useSize	1	Integer	Usage count
├─├─ orderId	VMOS-CLOUD174583355706782096	String	System order number
├─├─ outOrderId	1916791090664861697	String	External order number

Request Example

/vcpcloud/api/vcEmailService/getEmailOrder?page=1&size=10&serviceId=2&email=yzxovmq&status=0

Response Example

{
    "msg": "success",
    "code": 200,
    "data": {
        "current": 1,
        "total": 1,
        "pages": 1,
        "size": 10,
        "records": [
            {
                "emailServiceName": "Tiktok",
                "emailTypeName": "Gmail",
                "useSize": 2,
                "orderId": "VMOS-CLOUD174592947484442767",
                "updateTime": 1747135883000,
                "goodPrice": 0.03,
                "userId": 10667,
                "emailTypeId": 3,
                "emailCode": "767170",
                "emailStatus": 3,
                "createTime": 1745929475000,
                "emailServiceId": 3,
                "outOrderId": "1917193290790019073",
                "id": 468,
                "email": "jessicaadams316490@gmail.com"
            }
        ]
    },
    "ts": 1745835489149
}

Refresh to Get Email Verification Code

This interface refreshes the verification code list result, need to be used together with the [Query Purchased Email List] interface

Endpoint URL

/vcpcloud/api/padApi/getEmailCode

Request Method

GET

Request Data Type

application/json

Request Body Parameters

Parameter Name	Example Value	Data Type	Description
orderId	1917193290790019073	String	Required, corresponds to outOrderId field

Response Parameters

Parameter Name	Example Value	Data Type	Description
msg	success	String	Response message
code	200	Integer	Status code
ts	1745835489149	Long	Timestamp (milliseconds)

Request Example

/vcpcloud/api/vcEmailService/getEmailCode?orderId=1917193290790019073

Response Example

{
    "msg": "success",
    "code": 200,
    "ts": 1745835489149
}

Configuration Instructions

Customers need to configure the callback URL on the WEB side. Once the address is configured successfully, receiving callback information will be enabled by default.

Asynchronous ADB Command Callback

Use Case

When a customer calls the asynchronous execution of ADB commands, they will be notified through this callback interface.

Field	Type	Example	Description
taskBusinessType	Integer	1002	Task business type
taskId	Integer	1	Task ID
padCode	String	AC22030022001	Instance identifier
taskStatus	Integer	3	Task status (-1: Total failure; -2: Partial failure; -3: Cancel; -4: Timeout; 1: Pending; 2: Executing; 3: Completed)
endTime	Long	1756021166163	Task end time
taskResult	String	Success	Task result
taskContent	String		Task content
cmd	String	cd /root;ls	Executed command
cmdResult	String	/ws	Command return value

Example

{
    "cmd": "cd /root;ls",
    "cmdResult": "/system/bin/sh: <stdin>[1]: cd: /root: No such file or directory",
    "endTime": 1734942133000,
    "padCode": "AC22030022001",
    "taskContent": null,
    "taskId": 10614,
    "taskResult": "/system/bin/sh: <stdin>[1]: cd: /root: No such file or directory",
    "taskStatus": 3
}

Instance File Upload Callback

Use Case

When a customer calls the instance file upload API, they will be notified through this callback interface.

Field	Type	Example	Description
taskBusinessType	Integer	1009	Task business type
taskId	Integer	1	Task ID
result	boolean	true	Execution result: true-success, false-failure
errorCode	String		Error code
padCode	String	AC22030022001	Instance number
fileId	String	cf08f7b685ab3a7b6a793b30de1b33ae34	File ID

Example

{
    "errorCode": null,
    "fileId": "cfec132ab3c4e1aff5515c4467d9bbe460",
    "padCode": "AC22030022001",
    "result": true,
    "taskBusinessType": 1009,
    "taskId": 10659,
    "taskResult": "Success", 
    "taskStatus": 3
}

App Installation Callback

Use Case

When a customer calls for app installation, the installation status will be notified to the customer through this callback interface.

Field	Type	Example	Description
taskBusinessType	Integer	1003	Task business type
taskId	Integer	1	Task ID
apps	Object[]		App information
├─ appId	Integer	10001	App ID
├─ appName	String	demo	App Name
├─ pkgName	String	com.xxx.demo	Package Name
├─ padCode	String	AC22030022001	Instance number
├─ result	boolean	true	Installation result flag. true: success, false: failure
├─ failMsg	String	This app is blacklisted and forbidden from installation	Failure message

Example

{
    "endTime": 1734939747000,
    "padCode": "AC22030022001",
    "taskBusinessType": 1003,
    "taskContent": "",
    "taskId": 10613,
    "taskResult": "Success",
    "taskStatus": 3
}

App Uninstallation Callback

Use Case

When a customer calls for app uninstallation, the uninstallation status will be notified to the customer through this callback interface.

Field	Type	Example	Description
taskBusinessType	Integer	1004	Task business type
taskId	Integer	1	Task ID
apps	Object		App information
├─ appId	Integer	10001	App ID
├─ appName	String	demo	App Name
├─ pkgName	String	com.xxx.demo	Package Name
├─ padCode	String	AC22030022001	Instance number
├─ result	boolean	true	Uninstallation result flag. true: success, false: failure

Example

{
    "endTime": 1734940052000,
    "padCode": "AC22030022001",
    "taskBusinessType": 1004,
    "taskContent": "",
    "taskId": null,
    "taskResult": "Success",
    "taskStatus": 3
}

App Start Callback

Use Case

When a customer calls for app startup, the startup status will be notified to the customer through this callback interface.

Field	Type	Example	Description
taskBusinessType	Integer	1007	Task business type
taskId	Integer	1	Task ID
taskStatus	Integer	3	Task status (-1: Total failure; -3: Cancel; -4: Timeout; 1: Pending; 2: Executing; 3: Completed)
padCode	String	AC22030022001	Instance identifier
pkgName	String	xxx.test.com	Package Name

Example

{
    "taskBusinessType": 1007,
    "packageName": "com.quark.browser",
    "padCode": "AC22030022001",
    "taskId": 10618,
    "taskStatus": 3
}

App Stop Callback

Use Case

When a customer calls for app stopping, the stop status will be notified to the customer through this callback interface.

Field	Type	Example	Description
taskBusinessType	Integer	1005	Task business type
taskId	Integer	1	Task ID
taskStatus	Integer	3	Task status (-1: Total failure; -3: Cancel; -4: Timeout; 1: Pending; 2: Executing; 3: Completed)
padCode	String	AC22030022001	Instance identifier
pkgName	String	xxx.test.com	Package Name

Example

{
    "taskBusinessType": 1005,
    "packageName": "com.quark.browser",
    "padCode": "AC22030022001",
    "taskId": 10618,
    "taskStatus": 3
}

App Restart Callback

Use Case

When a customer calls for app restart, the restart status will be notified to the customer through this callback interface.

Field	Type	Example	Description
taskBusinessType	Integer	1006	Task business type
taskId	Integer	1	Task ID
taskStatus	Integer	3	Task status (-1: Total failure; -3: Cancel; -4: Timeout; 1: Pending; 2: Executing; 3: Completed)
padCode	String	AC22030022001	Instance identifier
pkgName	String	xxx.test.com	Package Name

Example

{
    "taskBusinessType": 1006,
    "packageName": "com.quark.browser",
    "padCode": "AC22030022001",
    "taskId": 10618,
    "taskStatus": 3
}

User Image Upload Callback

Use Case

When a user image is uploaded, the result is notified to the customer through this callback interface.

Field	Type	Example	Description
taskBusinessType	Integer	4001	Task business type
imageId	String	img-2505244083302766	Image ID
taskStatus	Integer	3	Task status (-1: Failure; 3: Completed)

Example

{
    "imageId": "img-2505244083302766",
    "taskBusinessType": 4001,
    "taskStatus": 3
}

One-Click New Device Callback

Use Case: After the One-Click New Device task is completed, the system notifies the customer through this interface.

Field	Type	Example	Description
taskBusinessType	Integer	1124	Task business type
padCode	String	212254	Instance number
taskStatus	Integer	3	Task status (-1: Total failure; -3: Cancel; -4: Timeout; 1: Pending; 2: Executing; 3: Completed)
taskId	Integer	1	Task ID
taskContent	String	-	Task content
endTime	Long	1756021166163	End time (millisecond timestamp)
taskResult	String	Success	Task result description

Instance Image Upgrade Task Callback

Use Case: Notification sent when the status of the instance image upgrade task changes.

Field	Type	Example	Description
taskBusinessType	Integer	1012	Task business type
padCode	String	212254	Instance number
taskStatus	Integer	3	Task status (same as above)
taskId	Integer	1	Task ID
taskContent	String	-	Task content
endTime	Long	1756021166163	End time
taskResult	String	Success	Task result

Instance Status Callback

Use Case: Notification sent to the customer when the running status or connection status of the instance itself changes.

Field	Type	Example	Description
taskBusinessType	Integer	999	Task business type
padCode	String	212254	Instance identifier
padStatus	Integer	10	Instance Status: -1: Deleted; 10: Running; 11: Restarting; 12: Resetting; 13: Upgrading; 14: Abnormal; 15: Not Ready; 16: Backing up; 17: Restoring; 18: Power Off; 19: Shutting down; 20: Powering on; 21: Shutdown Failed; 22: Boot Failed
padConnectStatus	Integer	1	Instance Connection Status: 1: Online; 0: Offline

Instance Restart/Reset Task Callback

Use Case: Notification regarding the results of instance restart (1000) or reset (1001) operations.

Field	Type	Example	Description
taskBusinessType	Integer	1000/1001	1000 for restart, 1001 for reset
padCode	String	212254	Instance number
taskStatus	Integer	3	Task status (-1: Failure; 1: Pending; 2: Executing; 3: Completed)
taskId	Integer	1	Task ID
endTime	Long	1756021166163	End time
taskResult	String	Success	Task result