Loading...
Area: Episerver Content Delivery API
Applies to versions: Not applicable
  Subscribe

Episerver Content Delivery API Developer Guide

Recommended reading 

What is Episerver Content Delivery API?

In Episerver CMS, you use built-in C# Razor helpers to render pages and blocks on a website. With the Episerver Content Delivery API, you can use Episerver CMS in a headless mode, which means all pages and blocks are rendered by reading JSON data returned from a REST API. You can build Episerver sites, Single Page Application (SPA) sites, mobile apps, or other external applications by retrieving Episerver page and content data over HTTP and without using the Episerver user interface. You can use Episerver Content Delivery API together with JavaScript frameworks such as React, Vue, or Angular to build your SPA sites.

Headless CMS vs non-headless CMS

A traditional non-headless CMS is built so that the CMS running on the server controls how the content is presented. The "head" is responsible for generating the HTML that is parsed and rendered by the browser.

TraditionalCMS.png

A headless CMS consists of a back-end content repository that can be accessed, for example, through a RESTful API, providing flexibility when pulling content data into other systems.

HeadlessCMS.png

The advantage of the headless CMS is that it is built up as a content repository that makes content accessible through REST APIs for display on multiple devices and across multiple channels. The "head" is the front-end, and the "body" is the back-end content repository. The "missing head" is the presentation layer. The headless CMS does not know how content is presented. It is a specialized database, serving content that is transformed into HTML by other systems. 

Episerver CMS has a powerful presentation layer, and as such is not a headless CMS. However, there are situations where a headless approach is preferred, to provide the ability to pull raw content from outside the presentation layer and this is where the Episerver Content Delivery API can be used.

Tip: For a general walk-through of hosting models, delivery architectures, and the differences between coupled, decoupled, and headless content management systems, see Episerver's Deane Barker's article Headless, SaaS, and Why Those Aren't Necessarily a Package Deal

Why should I use it?

The following are example scenarios when a headless approach is useful:

  • To provide content for native applications that are not HTML-based.
  • To integrate with a Point of Sales (POS) network, linking different output systems.
  • To manage content for legacy platforms/products inside Episerver.
  • To manage content for third-party platforms integrated with Episerver CMS without using the user interface.

The Content Delivery API is a flexible programming interface that you can use for building this type of solutions, using Episerver as a hub for all content. 

EpiserverHeadless.png

The Content Delivery API is a pluggable and configurable web API for querying IContent, providing you with the ability to:

See the Episerver Content Delivery API class library/SDK.

Documentation

The Content Delivery API developer guide is split into three parts:


  • Getting started section. This section contains eveything you need to get going with Content Delivery API, such as overviews, installation instructions, authorization, and setting up the REST API with search.
  • API fundamentals section. This part contains detailed descriptions and instructions on how to communicate with the API and its different endpoints.
  • REST API reference (Swagger) documentation. This part is automatically generated documentation from the source code and contains descriptions of the endpoints and models, used mainly for reference purposes.

Related topics

Blog posts

Do you find this information helpful? Please log in to provide feedback.

Last updated: Jul 02, 2020

Recommended reading