Skip to content

Swipe ​

Interface Address:

text
/papi/container/input/swipe

Request Method:

text
POST

Content-Type:

text
application/json

Header Parameters:

ParameterTypeRequiredDescription
X-Access-KeystringYesAPI access key ID; see API Rules
X-SignaturestringYesBase64-encoded HMAC-SHA256 signature
X-TimestampstringYesUnix timestamp in milliseconds (13 digits)
X-NoncestringYesRandom string of 10–32 lowercase letters and digits

Body Parameters:

ParameterTypeRequiredDescription
ctrIdstringYesCloud phone ID
x1integerYesStart X coordinate in pixels, ≥ 0
y1integerYesStart Y coordinate in pixels, ≥ 0
x2integerYesEnd X coordinate in pixels, ≥ 0
y2integerYesEnd Y coordinate in pixels, ≥ 0
durationintegerNoSwipe duration in milliseconds, ≥ 0; omit to use the cloud phone default

Request Example:

json
{
  "ctrId": "1820d3f652769ea325b3424b5b5c8da2d6d13451ee7b5b658ca6a71063bc73ed",
  "x1": 100,
  "y1": 500,
  "x2": 100,
  "y2": 200,
  "duration": 500
}

Response Parameters:

ParameterTypeDescription
codeintegerError code; see Error Codes
dataobjectOperation result
├─ successbooleanWhether the operation succeeded
├─ taskIdstringOperation task ID
├─ dataobjectAdditional data
├─ msgstringOperation message
├─ ctrIdstringContainer ID
├─ ctrAliasstringContainer alias
├─ ctrSlotintegerCloud phone slot
msgstringError message

Response Example:

json
{
  "code": 0,
  "data": {
    "success": false,
    "taskId": "",
    "data": {},
    "msg": "",
    "ctrId": "",
    "ctrAlias": "",
    "ctrSlot": 0
  },
  "msg": ""
}
Copyright © 2026 HongKong Quantity Best Technology Limited

QTPhone Help Center