Introduction
The TraceParts 3D Viewer Pro web component is the 3D standalone viewer provided by TraceParts.
Description
This web component provides a 3D viewer of the 3D model of one given configuration of a catalog.
Building a URL
The 3D viewer request takes the following form:
https://www.traceparts.com/els/{elsid}/en/api/viewer/3d?parametersParameters
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.
The final URL containing your EasyLink ID (ELSID) is provided with the Tenant Unique ID and the API key.
Required parameters
| Parameter Name | Data type | Default value | Description |
|---|---|---|---|
| SupplierID** | string | none | ClassificationCode provided by the "availability" endpoints |
| PartNumber** | string | none | Identifier of a product (to use in combination with SupplierID). Part number as stored in the TraceParts database. |
| Product* | string | none | PartFamilyCode provided by the "availability" endpoints |
*Both parameters (Product and SelectionPath) have to be used together. In this case, the couple “SupplierID” and “PartNumber” is not to use.
** Both parameters (SupplierID and PartNumber) have to be used together. In this case, the couple “Product” and “SelectionPath” is not to use.
Optional parameters (rendering)
| Parameter Name | Data type | Default value | Description |
|---|---|---|---|
| SelectionPath* | string | none | Sequence of parameters which defines a unique configuration for one given partFamilyCode. |
| SetBackgroundColor | Hexadecimal | 0xFFFFFF | Sets a color on the background of the 3D viewer. |
| DisplayCoordinateSystem | boolean | false | Display the coordinate system |
| EnablePresentationMode | boolean | false | The model rotates on the Y axis until a user interaction |
Optional parameters (toolbars)
| Parameter Name | Data type | Default value | Description |
|---|---|---|---|
| MenuAlwaysVisible | boolean | false | Always display the toolbar |
Example of 3D viewer call
The request below returns the 3D viewer of the part number “1857837” from the PHOENIX CONTACT catalog.
https://www.traceparts.com/els/phoenix-contact/en/api/viewer/3d?SupplierID=PHOENIX_CONTACT&PartNumber=1857837The language of the menu depends of the URL, having the TraceParts cultureInfo in the path. By default, the TraceParts 3D Viewer Pro is in English language (cultureInfo = en).
https://www.traceparts.com/els/{elsid}/{en}/api/viewer/3d?parameters