8月 31, 2022

BIM 360 Docs Export PDF API migrating to S3 signed url

Do you use BIM 360 Docs Export PDF API users? If so, please read on. We have an important, time sensitive information to share and your action is required.  

As part of the migration of S3 signed url downloading/uploadingGET export endpoint is updated to provide additional S3 signed url, (i.e., signedUrl field in the response). We can call this signed url to download the actual content. The current field, link, still functions at a moment for compatibility reason during migration period.

Action Required

If you are using GET export and downloading a pdf using 'link' field value, please migrate to use signedUrl by November 30, 2022, at which point, link field value will stop functioning. 

 

With this change, the old endpoint which looks like this: 

https://developer.api.autodesk.com/modelderivative/v2/designdata
/dXJuOmFkc2sud2lwcWE6ZnMuZmlsZTp2Zi5wZjNmclUwZ1RaYU9vdEtYZzJoMUZ3P3ZlcnNpb249MQ/manifest
/urn%3Aadsk.viewing%3Afs.file%3AdXJuOmFkc2sud2lwcWE6ZnMuZmlsZTp2Zi5wZjNmclUwZ1RaYU9vdEtYZzJoMUZ3P3ZlcnNpb249MQ%2
Foutput%2FqXP_ZA5_3EqJoq5zqvnLHA%2Fh8YAl4KMcEe9-L5SaEXY6A.pdf

will become like this with the new endpoint:  

https://autodesk-360-translation-storage.s3.amazonaws.com/dXJuOmFkc2sud2lwcWE6ZnMuZmlsZTp2Zi5wZjNmclUwZ1RaYU9vdEtYZzJoMUZ3P3ZlcnNpb249MQ
/output/qXP_ZA5_3EqJoq5zqvnLHA/h8YAl4KMcEe9-L5SaEXY6A.pdf
?X-Amz-Security-Token=XXXXX&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Date=20220805T023429Z
&X-Amz-SignedHeaders=host&X-Amz-Expires=300
&X-Amz-Credential=ASIATOYXB4XYG76TKVPE%2F20220805%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Signature=b7cdd11b4ad70051d652bf9f0fa7e49e24b08c800f71211c495d53db2c0509d8

Notice the change from "developer.api.autodesk.com/modelderivative/..." to "autodek-360-translation-storage.s3.amazonaws.com/..." 

You can find more information in the following documentation pages. 

Step-by-step Tutorial 

Reference Guide

 

Additional note: currently, there is a known issue about hyperlinks not working when the link path is relative. If the link has absolute, it works. This behavior is not new. It existed before. We have logged wish(ALEX-44348). 

If you encounter any issues or have any questions about the migration, please contact forge.help@autodesk.com            

Posted by

Xiaodong Liang has been with Autodesk since 2007, focusing on providing programming support, consulting, training and evangelism to external developers. He started his career China and now lives in Beijing, China. Xiaodong is currently a developer consultant in the team Developer Technical Services (DevTech), the worldwide team of API gurus providing technical services through the Autodesk Developer Network. He supports...

Mikako Harada

Mikako Harada works as an AEC technical lead and Americas manager for the Developer Technical Services (DevTech) team at Autodesk. She provides API (Application Programming Interface) technical support to the members of Autodesk Developer Network worldwide for AEC products.


Prior to joining Autodesk, she worked as a researcher for the Swiss Federal Institute of Technology (ETH) in Zurich. While at...

Related Posts