Task 2 – Make Your First Request
The Fusion Operations API provides access to products details through a REST endpoint
This task retrieves product details using the /products/{productId} endpoint.
Expected task outcome
By the end of this task, you will know how to use the Fusion Operations API to retrieve product details using a simple REST GET request.
API Endpoint used in this task
You use the following endpoint for this task:
| Name | Description |
|---|---|
| GET products | Fetches a single product identified by the specified unique product ID. |
Step 1 - Get Product Information via Fusion Operations API
- Ensure you have a valid 3-legged OAuth access token from Task 1. The Products endpoint requires user context and only works with 3-legged tokens.
- Make a GET request to the Products endpoint:
Endpoint:
https://api.aps.autodesk.com/fusion-operation/v2/products/{producId}Method: GET Path Parameter: productId - Headers:
Authorization: Bearer <YOUR_ACCESS_TOKEN>
- Example request using cURL:
curl --request GET \ --url 'https://api.aps.autodesk.com/fusion-operation/v2/products/1' \ --header 'Authorization: Bearer <YOUR_ACCESS_TOKEN>' - The response will contain product information. A successful response should be similar to this:
{ "id": 2, "code": "MySuperProd", "name": "MySuperProduct", "observations": "2025 version", "unitCost": 45.4, "unitPrice": 50.6, "families": [ { "id": 12, "code": "Products 2025", "name": "Products for year 2025" } ], "operations": [ { "id": 2, "code": "Setup", "name": "Setup" }, { "id": 3, "code": "Mounting", "name": "Mounting" } ], "variableParameters": [ { "id": 26, "code": "Size" } ], "notes": "Notes limit is 5000 characters", "boxQuantity": 4, "materialReceivingCheckList": { "id": 268, "code": "SupplierCode" }, "modificationDate": "2017-06-21T14:07:17Z", "standardUnitOfMeasurement": { "id": 3, "code": "Each", "name": "Each" }, "purchaseOrderUnitOfMeasurement": { "id": 3, "code": "Each", "name": "Each" }, "unitOfMeasurementGroup": { "id": 1, "code": "Default UoM Group" }, "weight": 6.3, "weightUnitOfMeasurement": { "id": 2, "code": "Kg", "name": "Kilogram" }, "disabled": false, "color": "#FFFFFF", "suppliers": [ { "id": 15, "code": "Supplier QWERTY" } ], "minimumInventory": 0, "maximumInventory": 50000, "minimumQuantityToReorder": 50, "quantityMultiple": 1, "scrapAllowance": 10, "shelfLife": 5, "leadTime": 7, "parameters": [ { "id": 67, "code": "Voltage", "value": "220V" } ], "serializable": false, "automaticSerialNumber": false }Show More
Key Features of Fusion Operations API
- REST Endpoint: Simple GET request, no GraphQL knowledge required
- 3-Legged OAuth: Requires user context authentication
- Rich Product Data: Includes operations, task durations, families, units of measurement and inventory information
- Rate Limited: 500 calls per minute
Error Handling
If the request fails, you’ll receive an error response:
{
"title": "Not Found",
"detail": "The URI requested is invalid or the resource requested does not exist."
}
Common error scenarios:
- 401 Unauthorized: Invalid or expired access token
- 403 Forbidden: Token doesn’t have required permissions
- 404 Not Found: The URI requested is invalid or the resource requested does not exist.
- 429 Too Many Requests: Rate limit exceeded (500 calls/minute)