autodesk-aps-skill

Autodesk Platform Services (APS) Integration

Provenance: extracted from autodesk-specialist-subagent. Domain knowledge for APS, Revit, Fusion 360, and AutoCAD API integration.

Autodesk Platform Services (APS) Overview

APS (formerly Forge) is Autodesk's cloud platform providing APIs for:

• Data Management API: Access BIM 360, ACC, and A360 data
• Model Derivative API: Convert 70+ CAD formats to SVF for viewing
• Viewer API: Embed 3D/2D viewers in web applications
• Design Automation API: Run Revit, AutoCAD, Inventor in the cloud
• Webhooks API: Event-driven automation
• Reality Capture API: Process photos into 3D models

APS Documentation

• Developer Portal: https://aps.autodesk.com/
• API Documentation: https://aps.autodesk.com/en/docs/data/v2/developers_guide/overview/
• Tutorials: https://aps.autodesk.com/tutorials
• GitHub Samples: https://github.com/Autodesk-Forge

Authentication Methods

1. Two-Legged OAuth (Client Credentials)

For server-to-server authentication without user context.

import fetch from 'node-fetch';

interface APSConfig {
  clientId: string;
  clientSecret: string;
}

async function get2LeggedToken(config: APSConfig): Promise<string> {
  const response = await fetch('https://developer.api.autodesk.com/authentication/v2/token', {
    method: 'POST',
    headers: {
      'Content-Type': 'application/x-www-form-urlencoded',
    },
    body: new URLSearchParams({
      client_id: config.clientId,
      client_secret: config.clientSecret,
      grant_type: 'client_credentials',
      scope: 'data:read data:write data:create bucket:create bucket:read',
    }),
  });

  const data = await response.json();
  return data.access_token;
}

2. Three-Legged OAuth (Authorization Code)

For user authentication with account access.

const APS_CLIENT_ID = process.env.APS_CLIENT_ID!;
const APS_CLIENT_SECRET = process.env.APS_CLIENT_SECRET!;
const REDIRECT_URI = 'http://localhost:3000/api/auth/callback';

function getAuthorizationUrl(state: string): string {
  const params = new URLSearchParams({
    response_type: 'code',
    client_id: APS_CLIENT_ID,
    redirect_uri: REDIRECT_URI,
    scope: 'data:read data:write user-profile:read',
    state,
  });
  return `https://developer.api.autodesk.com/authentication/v2/authorize?${params}`;
}

async function exchangeCodeForToken(code: string): Promise<TokenResponse> {
  const response = await fetch('https://developer.api.autodesk.com/authentication/v2/token', {
    method: 'POST',
    headers: {
      'Content-Type': 'application/x-www-form-urlencoded',
    },
    body: new URLSearchParams({
      grant_type: 'authorization_code',
      code,
      client_id: APS_CLIENT_ID,
      client_secret: APS_CLIENT_SECRET,
      redirect_uri: REDIRECT_URI,
    }),
  });
  return response.json();
}

interface TokenResponse {
  access_token: string;
  refresh_token: string;
  expires_in: number;
  token_type: string;
}