Request

Response

    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:

    NameDescription
    GET products Fetches a single product identified by the specified unique product ID.

    Step 1 - Get Product Information via Fusion Operations API

    1. 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.
    2. Make a GET request to the Products endpoint:

      Endpoint: https://api.aps.autodesk.com/fusion-operation/v2/products/{producId} Method: GET Path Parameter: productId

    3. Headers:
    • Authorization: Bearer <YOUR_ACCESS_TOKEN>
    1. Example request using cURL:

      curl --request GET \
           --url 'https://api.aps.autodesk.com/fusion-operation/v2/products/1' \
           --header 'Authorization: Bearer <YOUR_ACCESS_TOKEN>'
      
    2. 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)