1,openApi接口调用前言

1,openApi接口调用前言
    1),所有接口必须经过验签通过后方可调用
    2),统一网关地址: https://openapi.bangtu-ai.com 
除(2,根据租户号获取token)接口,,其他所有接口入参必须带上以下参数:   
| 名称 | 类型 | 是否必填 | 描述 |
| --- | --- | --- | --- |
|Tenant  | Header | 是	 | 租户Id |
| Authorization | Header | 是	 | token |
| Enterprise | Header | 是	 |企业id  |
X-SecretKey | Header | 是| 秘钥 |
X-Nonce| Header | 是| 随机数 |
X-Timestamp | Header | 是| 时间戳 |
X-Sign | Header | 是| 签名 |

2,接口验签:
  1),所有接口都需要进行验签, 制作签名方式如下:

| Header key | Header Value |
| --- | --- |
| tenantNum | 我司提供|
| X-SecretKey | 我司提供 |
| X-Nonce | 建议用Hutool UUID生成,例如:"01977917-d683-4b1b-b2e7-fb92024dc0a2" |
|X-Timestamp  | 当前时间戳 |
| X-Sign |  把上述X-SecretKey和X-Nonce和X-Timestamp 的value按次序进行字符串相加后计算MD5值 |

3,专业枚举

| 名称 | 类型 | 描述 |
| --- | --- | --- |
| 专业 |enum  | BUILDING(建筑), STRUCTURE(结构), DRAINAGE(给排水), HEATING(暖通), ELECTRICAL(电气) |
|  |  |  |

4,任务状态枚举

| 名称 | 类型 | 描述 |
| --- | --- | --- |
| 状态 |enum  | PROCEED("审图中"), SUCCESS("审图成功"),FAIL("失败"),CANCEL("取消"),ABORT("运营平台手动中止任务"),OUT_TIME("超时任务")|

5,图纸预审状态枚举

| 名称 | 类型 | 描述 |
| --- | --- | --- |
| 状态 |enum  | PRETRIAL("预审中"),PRETRIAL_SUCCEED("预审成功"), T3_CONVERTING("T3转换中"),OTHER_ISSUE("其他问题"), FILE_ISSUE("文件问题"),  VERSION_ISSUE("版本问题"),|

6,查询预审信息
==注意:==
 为提升用户体验,天正文件如果未转T3会导致预审失败,就此类问题我们做了技术提升,即我们会自动帮助用户将图纸转为T3.
在调用8,查询预审信息接口时,如果t3Converted为true,说明此类图纸是已经经过转T3的了,此时的id是转T3成功后的图纸id, originFileId:为原始图纸id.
7,请求头需要添加project
部分接口请求头中需添加porject,请求示例请参考对应的接口

8,业务方案性缺陷
帮图提供的任何接口，对场景层面，因方案设计缺陷、不符合行业惯例、与AI智能审图常识不符导致的业务场景不匹配，不做任何的方案性拖底,如整体方案缺陷造成的对接问题需自行适配业务调整!!!请对接同学提前确认具体产品业务层面无缺陷。

9,各专业识图
除了建筑,结构专业发起识图外,其他专业(暖通,电气,给排水)需要先上传其对应的建筑专业.需要和建筑专业图纸联动进行AI审查。请先在本项目建筑专业入口上传建筑专业图纸并完成预审后，再开始AI审查