Skip to content

在线看图链接 ​

接口概述 ​

根据任务 ID、专业、租户与企业信息生成在线看图(Viewer)跳转链接,可在浏览器中直接打开图纸并查看审查结果标注。

请求地址 ​

http
GET /shareUrl?taskId={taskId}&major={major}

请求头 ​

参数必填说明
apiKey是API 访问凭证
enterprise是企业 ID,小写请求头
tenant是租户 ID,小写请求头

请求参数 ​

参数类型必填说明
taskIdString是审查任务 ID
majorString是专业,取值参见专业

请求示例 ​

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
}

返回字段 ​

字段类型说明
codeNumber通用响应码,200 表示成功
messageString响应信息
dataString在线看图链接
timestampNumber服务端响应时间戳,单位为毫秒

响应码 ​

code说明
200请求成功
500请求失败

注意事项 ​

  • taskId、major、enterprise、tenant 均为必填。
  • 生成的链接包含租户与企业信息,请在受信任的业务系统中分发。
  • 建议通过开启 AI 智能审查创建任务后再调用本接口。