Check Derivative Details
HEAD
{urn}/manifest/{derivativeUrn}
Returns information about the specified derivative.
This endpoint returns a set of headers similar to that returned by Download Derivative.
You can use this operation to determine the total content length of a derivative before you download it. If the derivative is large, you can choose to download the derivative in chunks, by specifying a chunk size using the Range header parameter.
Resource Information
Method and URI | HEAD https://developer.api.autodesk.com/modelderivative/v2/designdata/{urn}/manifest/{derivativeUrn} |
Method and URI (EMEA) | HEAD https://developer.api.autodesk.com/modelderivative/v2/regions/eu/designdata/{urn}/manifest/{derivativeUrn} |
Authentication Context | user context optional |
Required OAuth Scopes | data:read or viewables:read |
Data Format | JSON |
Request
Headers
Authorization* string | Must be Bearer <token> , where <token> is obtained via
POST /authentication/v2/token. |
region enum: string | Specifies the data center where the specified manifest and derivative are stored in. Possible values are:
Note:
|
* Required
Request
URI Parameters
urn string | The Base64 (URL Safe) encoded design URN |
derivativeUrn string | The URL-encoded URN of the derivatives. The URN is retrieved from the Fetch Manifest endpoint. |
Response
HTTP Status Code Summary
200 OK | Success. |
202 ACCEPTED | Request accepted but processing not complete. Call this endpoint again, until getting 200 OK. |
400 BAD REQUEST | Invalid request. E.g., the input URN format is invalid, or the range header is specified but not formatted correctly. |
401 UNAUTHORIZED | Invalid authorization header. |
403 FORBIDDEN | Access denied regardless of authorization status. |
404 NOT FOUND | Endpoint does not exist. |
500 INTERNAL SERVICE ERROR | Unexpected service interruption |
Response
HTTP Headers
Content-Type string | application/octet-stream . |
Content-Length string | Denotes the size of the specified derivative in bytes. |
x-ads-app-identifier string | The service identifier. Comprises of the service name, version, and environment. |
x-ads-startup-time string | The service startup time with data format EEE MMM dd HH:mm:ss Z yyyy . |
x-ads-duration string | The request duration in milliseconds. |
x-ads-troubleshooting string | Provides information about the server failure. |
Example
Successful retrieval of derivative’s metadata (200)
Request
curl -X 'HEAD'\
-H 'Authorization: Bearer ztcaB2R0f92bsV6iV0bSDgwmSVaW' \
-v 'https://developer.api.autodesk.com/modelderivative/v2/designdata/dXJuOmFkc2sub2JqZWN0czpvcy5vYmplY3Q6bW9kZWxkZXJpdmF0aXZlL0E1LnppcA/manifest/urn%3Aadsk.viewing%3Afs.file%3AdXJuOmFkc2sub2JqZWN0czpvcy5vYmplY3Q6bW9kZWxkZXJpdmF0aXZlL0E1LnppcA%2Foutput%2F1%2FA5.svf'
Response
Status Code: 200 OK
Content-Type=application/octet-stream
Content-Length:1658
x-ads-app-identifier:platform-viewing-2016.05.03.1102.2f6bfbf-production
x-ads-startup-time:Wed May 11 14:03:54 CST 2016
x-ads-duration:280 ms