Skip to content
SDK for Kentico Kontent Management API
TypeScript JavaScript
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.circleci
.github
.vscode
demo
lib
misc
test-browser
test-node
.gitignore
.npmignore
.prettierrc
.travis.yml
CHANGELOG.md
CODE_OF_CONDUCT.md
CONTRIBUTING.md
LICENSE
LICENSE.md
README.md
karma-travis.conf.js
karma.conf.js
package-lock.json
package.json
tsconfig.json
tsconfig.prod.json
tsconfig.webpack.json
tslint.json
webpack.config.js
webpack.legacy.config.js

README.md

Kontent management javascript SDK

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

npm version Build Status CircleCI npm Known Vulnerabilities GitHub license Gzip bundle

Getting started

To get started, you'll first need to have access to your Kentico Kontent 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/kontent-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.

<script src="https://cdn.jsdelivr.net/npm/rxjs/bundles/rxjs.umd.min.js"></script>
<script src="https://cdn.jsdelivr.net/npm/@kentico/kontent-management/_bundles/kontent-management.umd.min.js"></script>

Making the first request

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

import { ManagementClient } from '@kentico/kontent-core';

const client = new ManagementClient({
        projectId: 'xxx', // id of your Kentico Kontent 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 KontentManagement global variable.

<!DOCTYPE html>
<html>
<head>
	<title>Kontent management | jsdelivr cdn</title>
    <script src="https://cdn.jsdelivr.net/npm/rxjs/bundles/rxjs.umd.min.js"></script>
    <script src="https://cdn.jsdelivr.net/npm/@kentico/kontent-management/_bundles/kontent-management.umd.min.js"></script>
</head>
<body>
    <script type="text/javascript">
        var KontentManagement = window['KontentManagement'];

		var client = new KontentManagement.ManagementClient({
			projectId: 'xxx',
			apiKey: 'yyy'
		});

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

Configuration

The ManagementClient contains several configuration options:

const client = new ManagementClient({
    // configuration options
});
Option Default Description
projectId N/A Required - Id of your Kentico Kontent project
apiKey N/A Required - Content management API Token
baseUrl https://manage.kontent.ai/v2/projects Base URL of REST api. Can be useful if you are using custom proxy or for testing purposes
retryAttempts 3 Number of retry attempts when error occures. To disable set the value to 0.
httpService HttpService Used to inject implementation of IHttpService used to make HTTP request across network. Can also be useful for testing purposes by returning specified responses.
retryStatusCodes [500] Array of request status codes that should be retried.

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.

You can’t perform that action at this time.