Skip to content
API Reference
/
/
/
Cloud phone screen captur...

Cloud phone screen capture

Request

Capture the Cloud Phone screen and return a download URL.

  • Preconditions: the phone must be powered on and not held by another member. Supported on compatible device models only; incompatible models reject the call.
  • Effect: on some models the screenshot file is removed from the device after it is captured.
  • Completion: synchronous. The response includes a temporary image download URL.
  • Caveat: on some models the reported expiry is a fixed one hour from the response and success is always true — it is not the real signature lifetime. Download promptly rather than storing the URL.
  • Retry: no side effect beyond the capture itself, so it is safe to repeat.
Bodyapplication/jsonrequired
idstringrequired

cloud phone ID

Example:"1558968155668507"
curl -i -X POST \
  http://127.0.0.1:40000/api/cloudphone/screenCap \
  -H 'Content-Type: application/json' \
  -d '{
    "id": "1558968155668507"
  }'

Responses

Success. data is an object with the fields url, status, expireAt and success.

Bodyapplication/json
codeinteger

Response code: 0 = success, >0 = error

dataobject
msgstring or null

Message; populated if code > 0

requestIdstring

Unique request identifier; include it when contacting support

Response
{
  "code": 0,
  "data": {
    "url": "http://oss.morelogin.com/test.png",
    "status": "finish",
    "expireAt": "1756024767163",
    "success": true
  },
  "msg": null,
  "requestId": "0d8b6f1c-9f4e-4d02-9d1a-7c3f5a1b2c3d"
}