文档首页/ 软件建模 CodeArts Modeling/ API参考/ 相关API接口/ 模型图/ 批量查询模型图图片下载链接
更新时间:2026-11-06 GMT+08:00
分享

批量查询模型图图片下载链接

功能介绍

批量查询模型图图片下载链接,通过链接下载图片文件

URI

POST /v1/modelproject/{uuid}/diagram-images

请求参数

表1 Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

参数解释:

用户Token。通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

表2 Path参数

参数

是否必选

参数类型

描述

uuid

是

String

参数解释:

软件建模工程id。

通过查询模型工程列表接口获取,响应消息体content中的model_project_uuid就是软件建模工程id。

约束限制:

由数字、字母、'-'组成。

取值范围:

32/36位字符。

默认取值:

不涉及。

表3 Query参数

参数

是否必选

参数类型

描述

version_uuid

是

String

参数解释:

分支uuid。master分支传空字符串。

通过查询工程分支信息获取。

约束限制:

由数字、字母、'-'组成。

取值范围:

空字符串、32/36位字符。

默认取值:

空字符串

表4 Body参数

参数

是否必选

参数类型

描述

diagram_uuids

是

Array of strings

参数解释:

图uuid列表,可传多个,单次最多查询50张模型图。获取方式:

  1. 通过批量查询图接口获取,响应消息体content中的uuid就是图uuid。
  2. 通过查询工程树接口获取,响应消息体content中diagrams数组中的uuid就是图uuid。

约束限制:

图uuid由32/36位数字、字母、'-'组成。

取值范围:

1到50个图uuid。

默认取值:

不涉及。

响应参数

状态码: 200

表5 响应Body参数

参数

参数类型

描述

status

String

参数解释:

接口返回的状态信息

取值范围:

success:执行成功,

failed:执行失败。

error_code

String

参数解释:

错误码。

取值范围:

不涉及。

error_msg

String

参数解释:

错误描述。

取值范围:

不涉及。

result

Object

参数解释:

响应对象。

取值范围:

不涉及。

表6 result参数

参数

参数类型

描述

content

Arrays of content objects

参数解释:

模型图响应体内容。

取值范围:

不涉及。

count

Integer

参数解释:

分页返回的总条数。

取值范围:

不涉及。

表7 content 参数

参数

参数类型

描述

diagram_uuid

String

参数解释:

模型图uuid。

取值范围:

不涉及。

diagram_name

String

参数解释:

模型图名称。

取值范围:

不涉及。

modeling_image_url

String

参数解释:

图片下载链接,有效期7天。下载文件为无后缀文件,需要修改后缀为png后可查看

取值范围:

不涉及。

请求示例

POST https://{endpoint}/v1/modelproject/52145be6702d4831bf7c3dac82a5f416/diagram-images?version_uuid=

{
    "diagram_uuids":["647493b85e83430b962ca88985b47db6"]
 }

响应示例

状态码: 200

success

{
    "status": "success",
    "error_code": null,
    "error_msg": null,
    "result": {
        "content": [
            {
                "diagram_uuid": "647493b85e83430b962ca88985b47db6",
                "diagram_name": "逻辑模型_123",
                "modeling_image_url": "https://alpha-image.obs.cn-***-6.my***cloud.com:443/cloudmodeling/image/diagram/52145be6702d4831bf7c3dac82a5f416/master/647493b85e83430b962ca88985b47db6?AccessKeyId=264b3416-e10e-46c5-ae5e-12d7d4deeee8&Expires=1753770093&Signature=2N%2B7v9hB93raP87tVEkm4n4aAjo%3D"
            }
        ],
        "count": 1
    }
}

状态码

状态码

描述

200

success

错误码

参考错误码。

相关文档