Important!
The 3D print API is shutting down on January 15, 2017. See our end of life notice for more information.
GET printers/command/:task_id¶a>
Returns the status of a command that was sent to a printer using the POST printers/printer_id/command
Resource Information¶
| Method and URI | GET https:/ |
| Authentication Context | user context required |
| Required OAuth Scopes | data:read data:write |
| Data Format | JSON |
Request¶
HTTP Headers¶
Name |
Required |
Value Type |
Description |
|---|---|---|---|
| Authorization | yes | string | Must be Bearer <token>, where <token> is obtained via a three- |
URI Parameters¶
Name |
Required |
Value Type |
Description |
|---|---|---|---|
| task_id | yes | string: UUID | task identifier that recieved in the
POST printers/ |
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)¶
The response body is a single, flat JSON object with the following attributes:
Attribute |
Value Type |
Description |
|---|---|---|
| progress | float | value between 0 and 1 that represents the percentage complete |
| data | object | extended information about the current job |
| data.job_status | enum: string | status of the job |
| data.total_layers | int | total number of layers to print |
| data.layer | int | current layer being processed |
| data.seconds_left | int | seconds left for the job |
| data.temperature | int | temperature in Centigrade of the printer |
| data.job_id | string: UUID | ID of the job |
| printer_status | enum: string | The status of the printer |
| job_id | string: UUID | The ID of the job |
| job_progress | float | value between 0 and 1 that represents the percentage complete |
| job_status | enum: string | |
| status_update_time | string | last time the job status was updated in <month_name> D, YYYY HH:mm:ss format |
| command | enum: string | issued command |
Examples¶
Successful Retreival of a Command Status (200)¶
curl -X 'GET' -H 'Authorization: Bearer m17SbcLhQRcLTUbkJXoKR53Rk8lj' -v 'https://developer.api.autodesk.com/ps/v1/print/printers/command/6ace3ef1-2fa0-4231-8288-0c64d7481e08'
{
"progress": "0.34",
"data": {
"job_status": "printing",
"total_layers": "50",
"layer": "17",
"seconds_left": "660",
"temperature": "71",
"job_id": "bfb1f23c-7b6b-4851-b7a9-46d5b0c82f50"
},
"printer_status": "printing",
"job_id": "bfb1f23c-7b6b-4851-b7a9-46d5b0c82f50",
"job_progress": "0.34",
"job_status": "printing",
"status_update_time": "April 23, 2015 06:23:23",
"command": "resume"
}
