Important!
The 3D print API is shutting down on January 15, 2017. See our end of life notice for more information.
GET printerTypes/:id¶a>
Retrieves details of a specific printer type.
A printer type describes a particular 3D printer model. Data is provided by the printer manufacturer. Forge supports printers with a rectangular build volume.
Resource Information¶
| Method and URI | GET https:/ |
| Authentication Context | none |
| Data Format | JSON |
Response¶
HTTP Status Code Summary¶
Code |
Message |
Meaning |
|---|---|---|
| 200 | OK | Successful |
| 400 | Bad Request | Invalid request. E.g., the request could not be parsed. |
| 401 | Unauthorized | Invalid authorization header. E.g., user is not logged in, or cannot access resource. |
| 404 | Not Found | Endpoint does not exist. |
| 422 | Unprocessable Entity | Semantic errors |
| 429 | Precondition Required | Request rate limit exceeded |
| 500 | Internal Server Error | An unknown error occurred on the server. |
Body Structure (200)¶
A successful response returns the requested printer type object.
Field |
Type |
Description |
|---|---|---|
| id | string: UUID | Printer type ID |
| version | int | Incremented every time this printer type ID is updated |
| profile_id | string: UUID | Profile that provides the printing and slicing settings (see Profile object) |
| manufacturer | string | Printer hardware manufacturer’s name |
| name | string | Printer model’s name |
| technology | enum: string | Printing technology used by the hardware:
DLP (digital light processing)FDM (fused deposition modeling) |
| default_material_id | string: UUID | ID of the default material for this printer type |
| default_profile_id | string: UUID | ID of the default profile for this printer type |
| icon_id | string | ID of a PNG icon file for the printer type |
| supported_connections | array: object | Type of printer, printer protocol, and printer info |
| build_volume | object | Information about the build volume of the printer hardware |
| build_volume.type | enum: string | Possible values:
cartesian (a rectangular prism)cylindrical (a cylinder) |
| build_volume.bed_size | array: int | Volume dimensions (usually width, depth, and height) |
| build_volume.bed_file_id | string | ID of a bed visualization ZIP file containing OBJ data; must include one OBJ file, may also include an MTL file and PNG or JPG images |
| build_volume.park_position | array: int | Specifies where to position the extruder (in cm) after the print is complete |
| build_volume.home_position | array:int | Specifies the starting position of the extruder (in cm) |
| printable | object | The data that is sent to the printer |
| printable.packager_file_id | string | ID of a file containing a Lua script, which converts the slicer output into a printable file |
| printable.packager_data_files | array: object | Data files for packager |
| printer_capabilities | object | FDM printers only. The capabilities of the printer |
| printer_capabilities.num_extruders | int | FDM printers only. Number of extruders on the printer |
| printer_capabilities.nozzle_diameter | float | FDM printers only. Nozzle tip diameter in cm |
| printer_capabilities.nozzle_temp_max | int | FDM printers only. Maximum nozzle temperature in degrees Celsius |
| printer_capabilities.bed_temp_max | int | FDM printers only. Maximum temperature for the print bed in degrees Celsius
0 if not heated |
| printer_capabilities.xy_speed_max | float | FDM printers only. Maximum travel speed in the xy-plane in cm/sec. |
| printer_capabilities.z_speed_max | float | FDM printers only. Maximum travel speed in the z-plane in cm/sec. |
| printer_capabilities.e_speed_max | float | FDM printers only. Maximum speed of filament retraction/engagement in cm/sec. |
Examples¶
Successful Retreival of Specific Printer Type (200)¶
curl -X 'GET' -v 'https://developer.api.autodesk.com/ps/v1/printdb/printerTypes/7B7F944D-5F30-4C49-AA95-837D4B441260'
{
"id" : "7B7F944D-5F30-4C49-AA95-837D4B441260",
"manufacturer" : "Autodesk",
"model" : "Ember",
"technology" : "DLP",
"firmware" : "Custom",
"output" : "PNG-GZIP",
"supported_connections" : ["TCP_IP", "SD"],
"preferred_connection" : "TCP_IP",
"connections" : {},
"build_volume" : {},
"materials_types" :["PHOTORESIN"],
"max_materials" : 1,
"dlp_specs" : []
}
