CADFormatAvailability
CAD formats availability
Introduction
Some CAD formats can be unavailable for a part number and for one given configuration.
API Key
This web service requires an API Key. Please use the form to request your API Key.
Description
This API returns if a CAD format is available for one given configuration of a part number. Depending on the CAD file in the data, a CAD format can be unavailable.
Building a URL
The CADFormatAvailability API request takes the following form:
https://ws.tracepartsonline.net/tpowebservices/CADFormatAvailability?parameters
Parameters
Certain parameters are required while others are optional. As it is standard in URLs, all parameters are separated using the ampersand (&) character. The list of parameters and their possible values are enumerated below.
Required parameters
Parameter Name | Data type | Default value | Description |
---|---|---|---|
ApiKey | string | none | Code calling an API to track and control how the API is used |
Format | string | none | Answer file type (xml, json) |
CADFormatID | integer | none | CADFormatID given by the CADFormatsList API |
PartID* | string | none | PartID given by the SynchronizationData API |
ClassificationID** | string | none | ClassificationId given by the CatalogsList API |
PartNumber** | string | none | Part Number as it is exactly written in the TraceParts database |
Language | string | en | LanguageID given by the LanguagesList API |
Optional parameters
Parameter Name | Data type | Default value | Description |
---|---|---|---|
UserEmail | string | none | User email / User ID |
ActiveJsonLight | boolean | 0 | Enables the light version when json is the answer file type |
SelectionPath* | string | none | SelectionPath given by the SynchronizationData API |
*Both parameters (PartID and SelectionPath) have to be used together. In this case, the couple “ClassificationID” and “PartNumber” is not to use.
** Both parameters (ClassificationID and PartNumber) have to be used together. In this case, the couple “PartID” and “SelectionPath” is not to use.
Example of CADFormatAvailability API
The request below returns the availability as an xml file for the part number 43900011 from the catalog ASCO Numatics in Autodesk Inventor CAD format.
PartID and SelectionPath:
https://ws.tracepartsonline.net/tpowebservices/CADFormatAvailability?PartID=10-17102002-114249&SelectionPath=1|1|1|1|&CADFormatId=9&Language=en&Format=xml&ApiKey={ApiKey}
PartNumber and ClassificationID:
https://ws.tracepartsonline.net/tpowebservices/CADFormatAvailability?PartNumber=43900011&ClassificationID=ASCO_JOUCOMATIC&CADFormatId=9&Language=en&Format=xml&ApiKey={ApiKey}
By changing the Format and adding the ActiveJsonLight, CADFormatAvailability returns the availability as a light Json file.
https://ws.tracepartsonline.net/tpowebservices/CADFormatAvailability?PartID=10-17102002-114249&SelectionPath=1|1|1|1|&CADFormatId=9&Language=en&Format=json&ActiveJsonLight=1&ApiKey={ApiKey}
CADFormatAvailability responses
The CADFormatAvailability responses are returned in the Format indicated by the Format parameter within the URL request’s path.
JSON Output
A sample HTTP request is shown below, displaying the availability of a CAD format.
{
"Availability":true
}
XML Output
Same example as above.
<WsCADFormatAvailability>
<Availability>true</Availability>
</WsCADFormatAvailability>
CADFormatAvailability response elements
The CADFormatAvailability response contain one element:
- “Availability”: the value is “true” or “false” if the configuration can provide or not a CAD file.
Developer support
Please contact us for any problem, question or comment related to this content integration.
Last updated June 30, 2015
Updated 7 months ago