31 Aug 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/uploading, GET 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