Screenshot APIs

Fresh

Take Screenshot

Request a screenshot of a running cloud phone. The result is delivered via webhook callback.

URL: https://openapi.geelark.com/open/v1/phone/screenshotMethod: POST

Request Parameters

Parameter	Required	Type	Description
id	Yes	string	Cloud phone ID

Response

Returns a taskId that will be sent to your webhook with the screenshot download link.

{
  "traceId": "123456ABCDEF",
  "code": 0,
  "msg": "success",
  "data": {
    "taskId": "528715748189668352"
  }
}

Get Screenshot Result

Query the result of a screenshot task.

URL: https://openapi.geelark.com/open/v1/phone/screenshot/resultMethod: POST

Request Parameters

Parameter	Required	Type	Description
taskId	Yes	string	Screenshot task ID

Response

{
  "traceId": "123456ABCDEF",
  "code": 0,
  "msg": "success",
  "data": {
    "status": 1,
    "downloadLink": "https://example.com/screenshot.jpg"
  }
}

Field	Description
status	0=pending, 1=success, 2=failed
downloadLink	URL to download the screenshot image

Error Codes

Code	Description
42001	Cloud phone does not exist
42002	Cloud phone is not in running state