FAQ
1. 获取FTP信息时接口无响应
问题描述
接入时,调用接口获取FTP信息,接口没有响应,返回500错误。
解决方法
检查调用接口的访问地址是否正确(https://api.3dopen.cn/)
2. 调用接口报错1
问题描述
接入时,调用接口报错,提示“授权参数缺失,缺少xxxx”。
解决方法
检查请求信息头,是否包含partnerID、shaKeyData、timeStampData 。
3. 调用接口报错2
问题描述
接入时,调用接口报错,提示“签名验证失败”。
解决方法
检查请求信息头中密钥shaKeyData生成是否正确。
4. 调用接口报错3
问题描述
接入时,调用接口报错,提示“请求IP不在白名单内”。
解决方法
登录门户网站(https://portal.3dopen.cn/index.html
),在“开发接口”页面的“白名单设置”中,如果白名单是开启状态,添加接口请求服务器对应的外网ip地址;或者联系管理员,关闭白名单设置。
5. 调用“插入任务”接口报错
问题描述
调用“插入任务”接口报错,提示“文件格式不支持”。
解决方法
联系管理员,开放企业账号相关的文件格式支持。
6. 转换失败1
问题描述
调用“插入任务”接口成功,转换失败,提示“提示文件下载失败”。
解决方法
确定输入转换模型文件路径是否正确,文件是否存在。(inputUrl方式,确定url是可以直接访问、下载,且不要带有权限解析的参数处理的http\https路径)
7. 转换失败2
问题描述
调用“插入任务”接口成功,转换失败,提示“文件不存在”。
解决方法
确定输入转换模型文件是否存在,如果是压缩包,确定对应的参数mainFile
指定的文件名在压缩包中存在,且如果压缩包有多层级文件夹,mainFile中有对应的相对路径。
8. 预览模型失败
问题描述
上传装配体时,转换成功,预览模型失败。
解决方法
装配体上传转换时,需要将整个装配体压缩成单个zip文件,然后上传服务器,使用单任务插入转换,调用“插入任务”接口需配置mainFile为压缩包中主装文件的文件名路径。
9. FTP下载模型失败
问题描述
模型转换成功,FTP下载模型时,下载失败。
解决方法
轻量化模型下载的FTP账号和密码,需要用查询任务返回的ftp信息(或者回调returnrul时返回的ftp信息),使用获取ftp信息接口获取的ftp信息只能用于上传模型。
10. 预览本地轻量化模型失败
问题描述
将轻量化模型文件下载到本地磁盘后,使用浏览器预览时,发现无法正常加载。按F12进入开发者页面,可以看到以下信息:
解决方法
禁用浏览器的同源策略。
以谷歌浏览器为例,禁用同源策略的步骤如下:
- 新建一个文件夹。例如 E:\chrome_ky
- 新建一个谷歌浏览器快捷方式。为方便区分,建议修改快捷方式名称,例如:"Google Chrome-跨域2"
- 右击新建的快捷方式,选择属性。在快捷方式页签,将以下代码加入目标文本框。
--disable-web-security --user-data-dir=E:\chrome_ky
- 单击应用,再单击确认。
- 要访问跨域资源,请双击新建的快捷方式,在打开的浏览器中,输入资源地址。
如果使用其它浏览器:
- 火狐浏览器:在地址栏输入:about:config,搜索”security.fileuri.strict_origin_policy”并设置该项为false。然后重启浏览器。
- 360浏览器:操作步骤参照谷歌浏览器。