@acoustic-content/delivery-sdk

Official JavaScript SDK for the Acoustic Content Delivery API.

Usage no npm install needed!

<script type="module">
  import acousticContentDeliverySdk from 'https://cdn.skypack.dev/@acoustic-content/delivery-sdk';
</script>

README

Acoustic

Acoustic Content Delivery JavaScript SDK

Official JavaScript SDK for the Acoustic Content Delivery API.

Motivation

This SDK is designed to help utilize the content hosted in Acoustic Content libraries in client and server-side applications (headlessly).

Table of Contents

Getting Started

Prerequisites

It is recommended to have the latest version of Node.js with npm installed to use this SDK in an application. To install Node.js, please follow the official documentation available on Node.js website.

Installing

This SDK is available for installation as a node module directly from the npm registry.

Install using npm:

$ npm i @acoustic-content/delivery-sdk

Usage

API Reference and Documentation

This SDK is based on the Acoustic Content API's delivery endpoints fully documented at Acoustic Developers website.

Additionally, you can generate the documentation with the use of TypeDoc by using a command:

npm run typedoc

How to Use?

To utilize this SDK, you need to import the library to your project first with:

const ContentDeliverySDK = require("@acoustic-content/delivery-sdk");

Request for Assets

ContentDeliverySDK.create({
  apiUrl: "",
})
  .deliverySearch()
  .assets()
  .get()
  .then((deliverySearchResult) => {
    // some actions with documents
  });

Request for Assets (with authorization)

If you want to make a request as an authorized user, please add username and password to the application's configuration:

ContentDeliverySDK.create({
  apiUrl: "",
  username: "",
  password: "",
})
  .deliverySearch()
  .contentItems()
  .protectedContent()
  .get();

You can find more examples in the sample folder.

Running the Tests

Install development dependencies:

$ npm i

Run Tests

Commands to run tests are provided in package.json.

Unit test mode:

$ npm run test

Integration test mode:

$ API_URL=<url> USERNAME=<username> PASSWORD=<password> npm run test

Built With

License

This project is licensed under the Apache License 2.0 - see the LICENSE file for details