外观
在线看图链接
接口概述
根据任务 ID、专业、租户与企业信息生成在线看图(Viewer)跳转链接,可在浏览器中直接打开图纸并查看审查结果标注。
请求地址
http
GET /shareUrl?taskId={taskId}&major={major}请求头
| 参数 | 必填 | 说明 |
|---|---|---|
| apiKey | 是 | API 访问凭证 |
| enterprise | 是 | 企业 ID,小写请求头 |
| tenant | 是 | 租户 ID,小写请求头 |
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| taskId | String | 是 | 审查任务 ID |
| major | String | 是 | 专业,取值参见专业 |
请求示例
bash
curl -X GET "https://openapi.bangtu-ai.com/openApi/shareUrl?taskId=1900789012345678901&major=BUILDING" \
-H "apiKey: YOUR_API_KEY" \
-H "enterprise: YOUR_ENTERPRISE_ID" \
-H "tenant: YOUR_TENANT_ID"返回结果
json
{
"code": 200,
"message": "success",
"data": "http://bangtu.bangtu-ai.com/viewer?type=TASK&taskId=1900789012345678901&tenantId=xxx&enterpriseId=xxx&major=BUILDING",
"timestamp": 1784533680000
}返回字段
| 字段 | 类型 | 说明 |
|---|---|---|
| code | Number | 通用响应码,200 表示成功 |
| message | String | 响应信息 |
| data | String | 在线看图链接 |
| timestamp | Number | 服务端响应时间戳,单位为毫秒 |
响应码
| code | 说明 |
|---|---|
| 200 | 请求成功 |
| 500 | 请求失败 |
注意事项
taskId、major、enterprise、tenant均为必填。- 生成的链接包含租户与企业信息,请在受信任的业务系统中分发。
- 建议通过开启 AI 智能审查创建任务后再调用本接口。