Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/petrbroz/aps-sdk-node
Tools for accessing Autodesk Forge APIs from modern Node.js apps.
https://github.com/petrbroz/aps-sdk-node
api async autodesk forge generator nodejs
Last synced: 5 days ago
JSON representation
Tools for accessing Autodesk Forge APIs from modern Node.js apps.
- Host: GitHub
- URL: https://github.com/petrbroz/aps-sdk-node
- Owner: petrbroz
- Created: 2018-09-26T21:18:15.000Z (over 6 years ago)
- Default Branch: develop
- Last Pushed: 2024-10-31T01:50:13.000Z (about 2 months ago)
- Last Synced: 2024-12-15T09:57:44.701Z (13 days ago)
- Topics: api, async, autodesk, forge, generator, nodejs
- Language: TypeScript
- Homepage: https://petrbroz.github.io/forge-server-utils/docs/index.html
- Size: 2.79 MB
- Stars: 35
- Watchers: 10
- Forks: 18
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
Awesome Lists containing this project
README
# aps-sdk-node
[](https://badge.fury.io/js/aps-sdk-node)
[](http://opensource.org/licenses/MIT)
Unofficial SDK for accessing [Autodesk Platform Services](https://aps.autodesk.com/) from Node.js applications
and from browsers, built using [TypeScript](https://www.typescriptlang.org) and modern language features like
[async/await](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Statements/async_function)
or [generators](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Statements/function*).
## Usage
### Server Side
The TypeScript implementation is transpiled into CommonJS JavaScript module with type definition files,
so you can use it both in Node.js projects, and in TypeScript projects:
```js
// JavaScript
const { DataManagementClient } = require('aps-sdk-node');
```
```ts
// TypeScript
import {
DataManagementClient,
IBucket,
IObject,
IResumableUploadRange,
DataRetentionPolicy
} from 'aps-sdk-node';
```
#### Authentication
If you need to generate [2-legged tokens](https://aps.autodesk.com/en/docs/oauth/v2/tutorials/get-2-legged-token)
manually, you can use the `AuthenticationClient` class:
```js
const { AuthenticationClient } = require('aps-sdk-node');
const { APS_CLIENT_ID, APS_CLIENT_SECRET } = process.env;
const auth = new AuthenticationClient(APS_CLIENT_ID, APS_CLIENT_SECRET);
const authentication = await auth.authenticate(['bucket:read', 'data:read']);
console.log('2-legged token', authentication.access_token);
```
Other API clients in this library are typically configured using a simple JavaScript object
containing either `client_id` and `client_secret` properties (for 2-legged authentication),
or a single `token` property (for authentication using a pre-generated access token):
```js
const { DataManagementClient, BIM360Client } = require('aps-sdk-node');
const dm = new DataManagementClient({ client_id: '...', client_secret: '...' });
const bim360 = new BIM360Client({ token: '...' });
```
#### Data Management
```js
const { DataManagementClient } = require('aps-sdk-node');
const { APS_CLIENT_ID, APS_CLIENT_SECRET } = process.env;
const data = new DataManagementClient({ client_id: APS_CLIENT_ID, client_secret: APS_CLIENT_SECRET });
const buckets = await data.listBuckets();
console.log('Buckets', buckets.map(bucket => bucket.bucketKey).join(','));
const objects = await data.listObjects('foo-bucket');
console.log('Objects', objects.map(object => object.objectId).join(','));
```
#### Model Derivatives
```js
const { ModelDerivativeClient } = require('aps-sdk-node');
const { APS_CLIENT_ID, APS_CLIENT_SECRET } = process.env;
const derivatives = new ModelDerivativeClient({ client_id: APS_CLIENT_ID, client_secret: APS_CLIENT_SECRET });
const job = await derivatives.submitJob('', [{ type: 'svf', views: ['2d', '3d'] }]);
console.log('Job', job);
```
#### Design Automation
```js
const { DesignAutomationClient } = require('aps-sdk-node');
const { APS_CLIENT_ID, APS_CLIENT_SECRET } = process.env;
const client = new DesignAutomationClient({ client_id: APS_CLIENT_ID, client_secret: APS_CLIENT_SECRET });
const bundles = await client.listAppBundles();
console.log('App bundles', bundles);
```
#### Reality Capture
```js
const { OutputFormat, RealityCaptureClient, SceneType } = require('aps-sdk-node');
const { APS_CLIENT_ID, APS_CLIENT_SECRET } = process.env;
const recap = new RealityCaptureClient({ client_id: APS_CLIENT_ID, client_secret: APS_CLIENT_SECRET });
const options = {
scenename: '',
scenetype: SceneType.Aerial,
format: OutputFormat.RecapPhotoMesh,
callback: ''
};
const photoscene = await recap.createPhotoScene(options);
console.log('Photoscene', photoscene);
```
### Client Side (experimental)
The transpiled output from TypeScript is also bundled using [webpack](https://webpack.js.org),
so you can use the same functionality in a browser. There is a caveat, unfortunately: at the moment
it is not possible to request APS access tokens from the browser
due to [CORS](https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS) limitations,
so when creating instances of the various clients, instead of providing client ID and secret
you will have to provide the token directly.
```html
const data = new APS.DataManagementClient({ token: '<your access token>' });
const deriv = new APS.ModelDerivativeClient({ token: '<your access token>' });
data.listBuckets()
.then(buckets => { console.log('Buckets', buckets); })
.catch(err => { console.error('Could not list buckets', err); });
deriv.submitJob('<your document urn>', [{ type: 'svf', views: ['2d', '3d'] }])
.then(job => { console.log('Translation job', job); })
.catch(err => { console.error('Could not start translation', err); });
```
Note that you can also request a specific version of the library from CDN by appending `@`
to the npm package name, for example, `https://cdn.jsdelivr.net/npm/[email protected]/dist/browser/aps-sdk-node.js`.
## Testing
```bash
export APS_CLIENT_ID=
export APS_CLIENT_SECRET=
export APS_BUCKET=
export APS_MODEL_URN=
yarn run build # Transpile TypeScript into JavaScript
yarn test
```