使用Data Management API返回的URN调用GetThumbnail遇404及相关问题咨询

Q1：thumbnails.data.id是什么？为何无法用于GetThumbnail接口？ #

thumbnails.data.id本质是文件的URN（Uniform Resource Name），但它是标准Base64编码格式，而Model Derivative API的GetThumbnail接口要求传入URL安全的Base64编码URN——需要对原始Base64字符串做转换：把+替换为-，/替换为_，并去掉末尾的=符号。

你直接解码后调用接口会返回400错误，是因为接口不接受解码后的明文URN，必须传入处理后的URL安全Base64格式。

Q2：调用thumbnails.meta.link.href返回404是否正常？如何正确获取缩略图？ #

404不属于预期情况，常见原因及解决方法如下：

• 文件未生成缩略图：如果是CAD类设计文件，需要先通过Model Derivative API提交转换作业，生成衍生模型及缩略图后才能访问；如果是文档、图片等非CAD文件，BIM 360通常会自动生成缩略图，但可能存在延迟，可等待一段时间后重试。
• 权限问题：检查请求头中的Authorization令牌是否包含data:read和modelderivative:read权限，同时确认令牌对应的账号有权限访问该BIM 360项目及文件。
• URN格式错误：即使使用返回的href链接，也要确保其中的URN是URL安全的Base64格式（部分场景下返回的链接可能存在格式问题，可手动替换字符后重试）。

正确的获取流程：

1. 确认文件类型：
   • 对于CAD文件：先调用Model Derivative API的转换作业接口，指定生成缩略图（thumbnail输出类型），待转换完成后，再用处理后的URL安全URN调用GetThumbnail接口。
   • 对于非CAD文件：直接调用Data Management API的获取文件缩略图接口（而非Model Derivative的接口），传入文件的itemId和versionId即可。

内容的提问来源于stack exchange，提问作者npnmodp