Adsk.Platform.ACC 0.2.8

Autodesk.ACC - Autodesk Construction Cloud SDK

A .NET SDK providing a Fluent API for the Autodesk Construction Cloud (ACC) APIs, generated from the official OpenAPI specifications using Microsoft Kiota.

Features

This SDK provides access to multiple ACC API endpoints through a unified client:

Installation

dotnet add package Adsk.Platform.ACC

Quick Start

using Autodesk.ACC;

// Provide a function that returns the access token
Func<Task<string>> getAccessToken = () => Task.FromResult("YOUR_ACCESS_TOKEN");

// Initialize the ACC client
var accClient = new ACCclient(getAccessToken);

Using with 2-Legged Authentication

For server-to-server communication using client credentials (2-legged OAuth), use the Autodesk.Authentication package:

using Autodesk.ACC;
using Autodesk.Authentication;
using Autodesk.Authentication.Helpers.Models;

// Your APS app credentials
var clientId = "YOUR_CLIENT_ID";
var clientSecret = "YOUR_CLIENT_SECRET";

// Define the required scopes
var scopes = new[] { "data:read", "data:write", "account:read" };

// Create authentication client
var authClient = new AuthenticationClient();

// Create an auto-refreshing token provider (handles token expiration automatically)
var tokenStore = new InMemoryTokenStore();
var getAccessToken = authClient.Helper.CreateTwoLeggedAutoRefreshToken(
    clientId, 
    clientSecret, 
    scopes, 
    tokenStore);

// Initialize the ACC client with auto-refreshing token
var accClient = new ACCclient(getAccessToken);

// Now you can use the client - tokens are refreshed automatically when needed
var issues = await accClient.Issues.Projects[projectId].Issues.GetAsync();

Usage Examples

Get Issues

// Get issues for a project
var issues = await accClient.Issues.Projects[projectId].Issues.GetAsync();

foreach (var issue in issues?.Results ?? [])
{
    Console.WriteLine($"Issue: {issue.Title} - Status: {issue.Status}");
}

Get Clash Results

// Get clash test results
var clashTests = await accClient.Clash.Containers[containerId].Clash.Tests.GetAsync();

Get Project Files

// Get files in a folder
var files = await accClient.Files.Projects[projectId].Folders[folderId].Contents.GetAsync();

Get RFIs

// Get RFIs for a project
var rfis = await accClient.RFIs.Projects[projectId].Rfis.GetAsync();

Using the Full API

For endpoints not available through shortcuts, use the Api property to access the full API structure:

// Access the full API
var result = await accClient.Api.Construction.Issues.V1.Projects[projectId].Issues.GetAsync();

API Structure

The SDK provides convenient shortcut properties for common endpoints:

Custom HttpClient

You can provide your own HttpClient instance for advanced scenarios:

var httpClient = new HttpClient();
// Configure your HttpClient...

var accClient = new ACCclient(getAccessToken, httpClient);

Rate Limiting

The SDK handles API rate limits automatically thanks to the built-in retry handler provided by the Kiota HTTP client. When the API returns a 429 Too Many Requests response, the SDK will:

• Automatically retry the request with exponential backoff
• Respect the Retry-After header returned by the API
• Retry up to a configurable number of times before failing

This means you don't need to implement custom retry logic in your application — the SDK handles transient failures and rate limiting transparently.

Error Handling

By default, the SDK throws an HttpRequestException for any non-successful HTTP response (4xx or 5xx status codes). This differs from Kiota's default behavior, which requires you to check the response status manually.

The exception includes:

• The request URI
• The HTTP status code
• The full HttpResponseMessage in the Data["context"] property, allowing you to inspect the request, headers, response body, and other details for debugging

try
{
    var issues = await accClient.Issues.Projects[projectId].Issues.GetAsync();
}
catch (HttpRequestException ex)
{
    Console.WriteLine($"Request failed: {ex.Message}");
    Console.WriteLine($"Status code: {ex.StatusCode}");

    // Access the full response for more details
    if (ex.Data["context"] is HttpResponseMessage response)
    {
        // Get request details
        Console.WriteLine($"Request URI: {response.RequestMessage?.RequestUri}");
        Console.WriteLine($"Request Method: {response.RequestMessage?.Method}");

        // Get response body
        var body = await response.Content.ReadAsStringAsync();
        Console.WriteLine($"Response body: {body}");
    }
}

If you prefer Kiota's default behavior (no automatic exception throwing), you can disable the error handler:

using Autodesk.Common.HttpClientLibrary.Middleware.Options;

// Disable error handling for a specific request
var requestConfig = new Action<RequestConfiguration<DefaultQueryParameters>>(config =>
{
    config.Options.Add(new ErrorHandlerOption { Enabled = false });
});

var issues = await accClient.Issues.Projects[projectId].Issues.GetAsync(requestConfig);

Requirements

• .NET 8.0 or later
• Valid Autodesk Platform Services (APS) access token with appropriate scopes

Documentation

• ACC API Documentation
• Autodesk Platform Services
• Microsoft Kiota Documentation

License

This project is licensed under the MIT License.