Sitecore Omni: Sitecore APIs Explained

Whether you are looking to leverage the headless CMS capabilities of Sitecore XP or simply looking to federate content and presentation via Sitecore's APIs, Sitecore Omni has exactly what you are looking for.

Sitecore Omni

Peeling the layers behind Sitecore Omni, here is everything you can get from Sitecore XP.

Sitecore APIs

For the purpose of this post, I will focus on the API layer of Sitecore. Sitecore provides the following APIs:


  1. Sitecore Services Client API
  2. Sitecore GraphQL API
  3.  Sitecore Layout Services API

Sitecore Services Client API

  • Uses ASP.NET Web API as foundation for a RESTful API.
  • Provide ItemService (Sitecore content items) and EntityService (custom business objects).
  • Allows execution of Sitecore Search.

Pros

  • Available OOTB in older and newer versions of Sitecore XP.
  • Provides read-only access to content item as JSON OData. No server-side code needed.
  • Provide RESTful API for CRUD operations on items and executing Sitecore Search queries.
  • Supports authentication and authorization.
  • No extra licensing cost.
  • Support request throttling (limit frequency of requests) & CORS.

Cons


  • Can be inefficient with bulky payload offering full content item definition instead of fetching a custom schema definition.
  • Can tend to be slower in performance depending on the usage.

Sitecore's GraphQL API


  • Sitecore GraphQL API is a generic GraphQL service platform on top of Sitecore.
  • Aimed at front-end development for SPA, PWAs, mobile apps.

Pros

  • Efficient and modern API returning light-weight response for queried data. Eliminated data over-fetching.
  • Help avoid the need for large number of RESTful API calls.
  • Better performance, saves bandwidth with advanced features like query batching.
  • Built-in schema introspection makes GUI query authoring tools, self-documentation, static analysis, and API mocking capabilities possible.
  • More maintainable than REST APIs and easily discoverable and queryable.
  • Seems to be the future of APIs and tends to replace traditional RESTful services.

Cons

  • Difficult to move from GraphQL to another technology.
  • Takes longer to build.
  • Comes as a paid add-on from Sitecore. (Please confirm with your Sitecore rep).

Sitecore's Layout Service

  • It is a REST endpoint providing data for Sitecore JSS apps.
  • Provides page layout (presentation) as structured data (JSON).
  • Supports Sitecore’s personalization, A/B & multivariate testing and Experience Editor.
  • Supports working with modern JavaScript frameworks & libraries like React, Angular and Vue.
  • Provides support for full headless architecture.
  • Requires additional licensing from Sitecore. (Please confirm with your Sitecore rep).

Comments

Post a Comment

Popular posts from this blog

RESOLVED: Solr Exceptions - Document contains at least one immense term in field

If you implemented Solr with Sitecore using Solr 5.x, you may run into the following error when indexing extremely large content in string fields: org.apache.solr.common.SolrException: Exception writing document id <xxxuniqueid> to the index; possible analysis error. Caused by: java.lang.IllegalArgumentException: Document contains at least one immense term in field="<xxxfieldname>" (whose UTF8 encoding is longer than the max length 32766), all of which were skipped. Please correct the analyzer to not produce such terms. The prefix of the first immense term is: '[10, 9, 9, 10, 32, 32, 32, 32, 32, 32, 82, 84, 82, 83, 32, 70, 97, 99, 105, 108, 105, 116, 121, 32, 10, 32, 32, 32, 32, 84]...', original message: bytes can be at most 32766 in length; got <intgreaterthan32766> Caused by: org.apache.lucene.util.BytesRefHash$MaxBytesLengthExceededException: bytes can be at most 32766 in length; got <intgreaterthan32766> This is due to the fa
Read more

Is Rendered Item Valid XHtml Document Could not find schema information warnings during publish item Sitecore 7.2

Image
Note: Since we now live in the HTML5 world, the simple resolution to any XHtml validation errors is to remove the XHtml validation rules on  System->Settings->Validation Rules->Global Rules item. Sitecore should update it's validation rules to be relevant to HTML5. This make the rest of this post obsolete :). I created a simple approval workflow in Sitecore 7.5 and tried to approve an item for publishing and found a bunch of validation errors in the Validation Results. Most of them were related to the "Is Rendered Item Valid XHtml Document" section which looked like this: The problems were related to violations of the W3C HTML5 recommendation An important note here is: The element containing the character encoding declaration must be serialized completely within the first 1024 bytes of the document. Adding the following xmlns attribute to the Html tag fixed most of the errors: <html lang="en" xmlns="http://www.w3.org/1999/
Read more

First look at Sitecore XM Cloud: Part 4 - Creating a new Site

Image
 Once you have successfully create an environment, you can go ahead and create your first site. In order to create a new Site, you need to launch the Sitecore Launchpad by clicking on the "XM Cloud Launchpad": Click on "Sites" menu to create a new Site: Click on "Add your first website" button to start the wizard. I chose the "Basic Site" template: Enter a Site name and pick a language and click on "Create website" button. You will see the following screen while your Site is being created: Once the Site is created, you can edit it in Pages or Explorer using the context menu: Explorer view of the Site: 1. "Details" view of page. 2. "Content" view of page: Unfortunately, trying to load the new Site in pages gives "Unable to connect to remote server"
Read more