Skip to content
API Reference
/
Cloud Phones
/
/Touch

Touch - Click

Request

Tap a point on the Cloud Phone screen.

  • Preconditions: the phone must be powered on and not held by another member. Supported on compatible device models only; incompatible models reject the call.
  • Coordinates: pos must hold exactly two values, [x, y]. They are not checked against the screen resolution — an off-screen point is passed through to the service.
  • Completion: synchronous. data.status is finish when the gesture completed, or pending when the service queued it. Some models always report finish. There is no endpoint to poll a pending gesture.
  • Retry: no deduplication. Two calls are two taps, so a blind retry after a timeout can double-tap.
  • Note: duration is accepted but ignored here; only long press reads it.

Documented business errors: 33300, 33301, 33401. See Error Codes for what each code means. Any operation can additionally return the common codes.

Security
Authorization
Bodyapplication/jsonrequired
idstringrequired

Cloud Phone ID

Example:"1558968155668507"
posArray of integers, = 2 itemsrequired

Tap coordinates [x, y]. The coordinate system uses the top-left corner as origin (0, 0).

Example:
[
  540,
  960
]
durationinteger

Press duration in milliseconds (used for long press). If omitted, the default duration is used.

Example:2000
curl -i -X POST \
  https://api.morelogin.com/cloudphone/touch/click \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "id": "1558968155668507",
    "pos": [
      540,
      960
    ]
  }'

Responses

Operation successful

Bodyapplication/json
codeinteger

Status code, 0 means success

Example:0
msgstring or null

Response message

Example:"success"
dataobject
Response
{
  "code": 0,
  "msg": "success",
  "data": {
    "status": "finish"
  }
}