JavaScript SDK
Build commerce applications with JavaScript/TypeScript
About the JavaScript SDK
The JavaScript SDK provides an easy interface for interacting with the commercetools platform. All HTTP methods and endpoints exposed in the commercetools platform are supported.
JavaScript SDK V2
JavaScript SDK V2 is autogenerated as a TypeScript library using our open source code generator. Based on the REST Modeling Framework, JavaScript SDK V2 gives you faster support for newly released API features and quicker bug fixes.
Additionally, it has exclusive support for the Machine Learning APIs and the Import API.
Installing API SDKs
- Platform API SDK::
npm install --save @commercetools/platform-sdk - Import API SDK::
npm install --save @commercetools/importapi-sdk - Machine Learning API SDK::
npm install --save @commercetools/ml-sdk
Other important Links
You can either use our previous SDK client or start using our new Beta SDK client V2 with the new V2 SDK models and API request builders.
The new Beta SDK client V2 has inbuilt HTTP and Auth and other middlewares and hence is easier to use.
JavaScript SDK V1
Features
Middleware
The JavaScript SDK has a middleware architecture, allowing plugins or middleware to be connected to the request. Middleware allows for easy extensibility of the SDK. More information about the architecture can be found here
The following middleware is currently supported:
Authentication
The JavaScript SDK supports all authentication flows listed here
If the SDK is used to generate the token, it stores a refresh token which is used to fetch a valid token if the old token expires.
Helper Libraries
These are libraries that help in building the final request.
api-request-builder
Helps construct the URI for the HTTP API endpoints in a declarative approach. Learn more
sync-actions
Helps generate update actions required to update an entity from an old state to a new state. Learn more
get-credentials
Helps retrieve project credentials from the environment or file system. Learn more
http-user-agent
Creates a HTTP user-agent that can be added to the request. Learn more