Important!
The 3D print API is shutting down on January 15, 2017. See our end of life notice for more information.
GET printerTypes¶a>
Retreives a list of Forge printer types.
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 |
Request¶
This endpoint does not require any request headers, query parameters, or body.
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 a JSON array of printer type objects.
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 Retrevial of Printer Types (200)¶
curl -X 'GET' -v 'https://developer.api.autodesk.com/ps/v1/printdb/printerTypes'
{
"printerTypes": [
{
"id": "7FAF097F-DB2E-45DC-9395-A30210E789AA",
"version": 1,
"name": "Ember",
"manufacturer": "Autodesk",
"model_number": "1.0.0",
"icon_id": "data/ember.png",
"icon50x50_id": "data/ember50x50.png",
"icon100x100_id": "data/ember100x100.png",
"technology": "DLP",
"default_material_id": "426F14FE-E6AF-496F-BBC7-7D6C0E16861D",
"default_profile_id": "34F0E39A-9389-42BA-AB5A-4F2CD59C98E4",
"firmware": {
"type": "Ember",
"version": "1.0.0"
},
"build_volume": {
"type": "Cartesian",
"bed_size": [
6.4,
4,
13.4
],
"bed_offset": [
-3.2,
-2,
0
],
"home_position": [
0,
0,
0
],
"park_position": [
0,
0,
0
],
"bed_file_id": "data/ember.zip"
},
"max_materials": 1,
"printable": {
"content": "image/png+tar.gz",
"thumbnail": "image/png",
"extension": "tar.gz",
"generates_supports": false,
"packager_file_id": "data/EmberPackager.lua"
},
"supported_connections": [
{
"type": "bonjour",
"protocol": "_http._tcp",
"info": {
"port": 3000,
"service_name": "Ember",
"api": {
"name": "SparkPrint",
"version": "1.0.0"
}
}
},
{
"type": "LAN",
"protocol": "_http._tcp",
"info": {
"port": 3000,
"api": {
"name": "SparkPrint",
"version": "1.0.0"
}
}
}
],
"preferred_connection": "bonjour",
"max_speeds": {
"z": 0.1
},
"software_info": {
"name": "Spark Print Studio",
"url": "www.spark.autodesk.com"
},
"printer_capabilities": {},
"_files": [
"icon_id",
"icon50x50_id",
"icon100x100_id",
"build_volume.bed_file_id",
"printable.packager_file_id"
]
}
]
}
