These docs are for v2.0. Click to read the latest docs for v2.1.

Overview

Welcome to the Cleeng API Reference! This is the right place if you want to build your ideal platform with an open API infrastructure. You’ll be able to seamlessly integrate identity, entitlement and billing functionality.

Our API Reference explains how to use the API to perform different operations: here you will find all the information you might need about endpoints, methods, requests and responses, parameters, fields and values.

For your convenience, this guide is divided into types of API. It documents the following:

  • MediaStore API - it is the latest Cleeng API organized around REST. It uses JWT as an authorization token. You can use it to build checkout and my account. This API is end-user-oriented. For more information see Getting started.

📘

MediaStore SDK Example App

You can find the SDK here. It consists of components that will empower you to build and design a seamless checkout process, help visitors become subscribers, and then allow them to manage their subscriptions.

  • API 3.1 - it is also REST API. It's authorized by ‘publisherToken’ in the header. If you'd like to find out more, please visit Getting started.

  • JSON RPC - it is a backend API: it's authorized by publisherToken. It is mainly used to manage: offers, publisher’s account and customers. For more information see Getting Started With JSON-RPC.

  • JS API (depreciated) - it's called from the frontend. It’s used in Cleeng-hosted solutions: classic checkout and my account. If you want to know more, see Getting started with JS API.

API Use Cases

We recommend using our new MediaStore APIs which are constantly developed. For the time being if you don’t see a MediaStore endpoint, you can use JSON RPC one.

Please note that JSON RPC is not actively developed; some methods will be deprecated. This will be clearly communicated on the API changelog.

See the guide below on API usage:

FunctionArchitectural setupRecommended APIDevices
Identity ManagementWith/without MiddlewareMediaStoreWeb & native Apps
My AccountWith/without MiddlewareMediaStoreWeb & native Apps
Checkout Implementation - webWith/without MiddlewareMediaStoreWeb
Payment configuration, webhooks and connectorsN/A3.1Web
Checkout implementation - native appsPreferably with MiddlewareJSON-RPC (& obviously store SDKs from Apple, Android, etc.)Native apps
EntitlementsWith/without MiddlewareJSON RPCWeb & native Apps
SSO IntegrationConfiguration with Middleware - if external identity provider applicableJSON RPC or MediaStore SDK. Depending on the use case. To learn more, contact usWeb & native Apps
Price / Product /Offer ManagementWith/without MiddlewareJSON RPCN/A

API Reference Organization

Each type of API is organized around core functions, so you will find them on the left followed by a list of endpoints below. You can also use the Search function at the top on the right to check and find out details of each method.

Within our API Reference, you can send test requests and view responses. You can also view the code for the request in various languages such as Node, Ruby, JavaScript and Python.

API Updates

We develop APIs to meet the needs of our customers. For more information on recent API updates,
visit our API Changelog.