Kentico Cloud Content management javascript SDK

> Javascript SDK for the Kentico Cloud Content Management API. Helps you manage content in your Kentico Cloud projects. Supports both node.js and browsers.

Getting started

To get started, you'll first need to have access to your Kentico Cloud project where you need to enable Content management API and generate access token that will be used to authenticate all requests made by this library.

Installation

This library has a peer dependency on rxjswhich means you need to install it as well. You install it using npm or use it directly in browser using one of the cdn bundles.

npm

npm i rxjs --save
npm i kentico-cloud-content-management --save

Using a standalone version in browsers

If you'd like to use this library directly in browser, place following script tags to your html page. You may of course download it and refer to local versions of scripts.

Making the first request

The following code example shows how to create new content item in your Kentico Cloud project.

import { ContentManagementClient } from 'kentico-cloud-content-management';

const client = new ContentManagementClient({
        projectId: 'xxx', // id of your Kentico Cloud project
        apiKey: 'yyy', // Content management API token
    });

    client.addContentItem()
        .withData(
            {
                name: 'New article',
                type: {
                    codename: 'article' // codename of content type
                }
            }
        )
        .toObservable()
        .subscribe((response) => {
            // work with response
        },
        (error) => {
            // handle error
        });

If you are using UMD bundles directly in browsers, you can find this library under KenticoCloudContentManagement global variable.

	<title>Kentico Cloud CM | jsdelivr cdn</title>
    
    


    

Configuration

The ContentManagementClient contains several configuration options:

const client = new ContentManagementClient({
    // configuration options
});

API Reference

Online API Reference documents latest version of this library and can be used to quickly find all exposed methods and objects. Documentation is generated from TypeScript code and thus it should always be accurate.

Testing

> If you want to mock http responses, it is possible to use external implementation of configurable Http Service as a part of the client configuration.

Troubleshooting & feedback

If you have any issues or want to share your feedback, please feel free to create an issue in this GitHub repository.

Contributions

Contributions are welcomed. If you have an idea of what you would like to implement, let us know and lets discuss details of your PR.