上传策略图片v3
更新时间 2026-11-09 14:58:44
最近更新时间: 2026-11-09 14:58:44
接口功能介绍
上传桌面水印企业Logo,并返回受保护的Token。图片要求:- 仅支持PNG或JPEG格式,文件签名与实际图片格式必须一致。- Base64解码后的图片大小不得超过200 KiB。- 图片宽度不得超过600 px,高度不得超过80 px。- imageBase64必须是严格RFC 4648 Base64内容,不得包含data URL前缀。返回的Token仅可用于原租户、原策略和DESKTOP_WATERMARK_LOGO类型,并通过设置屏幕安全策略接口应用。
接口约束
无
URI
POST /v3/strategy/image/upload
路径参数 无
Query参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| regionId | 是 | String | 资源池ID。 | xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx |
请求参数
请求头header参数 无
请求体body参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| strategyOid | 是 | String | 策略Oid。 | ||
| type | 是 | String | 策略图片类型。 取值: - DESKTOP_WATERMARK_LOGO: 桌面水印企业Logo。 | ||
| imageBase64 | 是 | String | 图片的Base64内容。 格式:严格RFC 4648 Base64。 不得包含data URL前缀。 编码后最长273068个字符。 解码后最大204800字节。 |
响应参数
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| statusCode | Integer | 状态码,800表示请求成功,900表示请求失败。 | 800 | |
| error | String | 错误码。 | ECPC_1000 | |
| message | String | 提示信息。 | OK. | |
| returnObj | String | 受保护的策略图片Token。 |
枚举参数
无
请求示例
请求url
https://{host}?regionId=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
请求头header
无
请求体body
{
"strategyOid":"dsy-xxxxxx",
"type":"DESKTOP_WATERMARK_LOGO",
"imageBase64":"iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAAC0lEQVR4nGP4DwQACfsD/fteaysAAAAASUVORK5CYII="
}
响应示例
{
"statusCode":800,
"message":"OK.",
"returnObj":"xxx"
}
状态码
请参考 状态码
错误码
请参考 错误码