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 Components
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 (deprecated) - 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:
|Function||Architectural setup||Recommended API||Devices|
|Identity Management||With/without Middleware||MediaStore||Web & native Apps|
|My Account||With/without Middleware||MediaStore||Web & native Apps|
|Checkout Implementation - web||With/without Middleware||MediaStore||Web|
|Payment configuration, webhooks and connectors||N/A||3.1||Web|
|Checkout implementation - native apps||With/without Middleware||MediaStore (& obviously store SDKs from Apple, Android, etc.)||Native apps|
|Entitlements||With/without Middleware||MediaStore||Web & native Apps|
|SSO Integration||Configuration with Middleware - if external identity provider applicable||JSON RPC or MediaStore SDK. Depending on the use case. To learn more, contact us||Web & native Apps|
|Price / Product /Offer Management||With/without Middleware||JSON RPC||N/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.
We develop APIs to meet the needs of our customers. For more information on recent API updates, visit our Release Notes page.