批量获取云机实时截图URL

接口说明

根据云机Id批量获取云机实时截图URL,可用于前端或者客户端显示云手机截图。


推荐使用API Explorer调试

API Explorer支持接口在线可视化调用,同时自动生成动态代码示例,搭配OpenAPI SDK无需计算签名实现接口快速集成。

URL

POST https://ecloud.10086.cn/api/openapi-cloudphone/api/v1/zycloudphone/console/zh/screenshot/url/batch

请求参数

Body

参数名称
类型
必填
描述
req
OpenapiGetScreenshotURLReq
是

req

phoneIds
<string> array
否

云机ID列表

请求示例

POST https://ecloud.10086.cn/api/openapi-cloudphone/api/v1/zycloudphone/console/zh/screenshot/url/batch
{
	"phoneIds":[
		"1984193887800250371"
	]
}

返回参数

返回码:200
OK
参数名称
类型
描述
body
<OpenapiGetScreenshotBinaryStreamResp> array

响应体

phoneId
string

云机id

screenshot
string

云机实时截图信息

errorCode
string

错误编码

errorMessage
string

错误信息

requestId
string

请求id

state
string

状态值

返回示例

返回码:200
OK
{
	"errorCode":"00000000",
	"errorMessage":"请求成功",
	"requestId":"20b991dd-83c1-4c98-8a9c-ee69ecb76e99",
	"state":"OK",
	"body":[
		{
			"phoneId":"1984193887800250371",
			"screenshot":"https://ecloud.10086.cn:31015/api/openapi-cloudphone/screenshot/180x,p20/pod-4bzb-f406e7815fd04570a09c6576ea653998/screen.jpg?AccessKey=23df5d5db57746a183770402b235569b&SignatureMethod=HmacSHA1&SignatureNonce=e31c0a7813a34f38a88f5a0690f65f6f&SignatureVersion=V2.0&Timestamp=2025-11-21T14%3A25%3A09Z&token=rfidGt6yrz%2FhLXTd0Mi8rQ%3D%3D&Signature=3f1a4d995f5341b8e939b6c05f876c70e7402438"
		}
	]
}
本文档内容整理自移动云官方帮助中心(查看原文),仅供参考。