Piranha CMS: example of a simple controller to GET data in JSON format for headless use.

ApiLessController.cs

using System;
using System.Collections.Generic;
using System.Linq;
using System.Threading.Tasks;
using Microsoft.AspNetCore.Mvc;
using Piranha;
using Piranha.AspNetCore.Services;
using Piranha.Models;
using PiranhaCMS.Models;
using Microsoft.AspNetCore.Authorization;

namespace PiranhaCMS.Controllers
{
 //[ApiController]
    [Route("api/head")]
    //[Authorize(Policy = Permissions.Pages)]
    public class ApiLessController : Controller
    {
        private readonly IApi _api;
        /// <summary>
        /// Default constructor.
        /// </summary>
        /// <param name="app">The current app</param>
        public ApiLessController(IApi api)
        {
            _api = api;
        }

        /// <summary>
        /// Gets the blog archive with the given id.
        /// </summary>
        [Route("jsonarchive")]
        public async Task<IActionResult> Archive(Guid id, int? year = null, int? month = null, int? page = null,
            Guid? category = null, Guid? tag = null)
        {
            //GetByIdAsync<Models.StandardPost>(id);
            var model = await _api.Pages.GetByIdAsync<Models.StandardArchive>(id);

            //model.Archive = await _api.Archives.GetByIdAsync(id, page, category, tag, year, month);

            return Json(model);
        }

        /// <summary>
        /// Gets the page with the given id.
        /// </summary>
        [Route("jsonpage")]
        public async Task<IActionResult> Page(Guid id)
        {
            var model = await _api.Pages.GetByIdAsync<PageBase>(id);

            return Json(model);
        }

        /// <summary>
        /// Gets the restricted page with the given id.
        /// </summary>
        /// <param name="id">The unique page id</param>
        /// For security read: https://piranhacms.org/blog/techniques-for-securing-pages
        [Route("jsonpagerestricted")]
        //[Authorize(Policy = ...)]
        public async Task<IActionResult> PageRestricted(Guid id)
        {
            var model = await _api.Pages.GetByIdAsync<PageBase>(id);

            return Json(model);
        }

        /// <summary>
        /// Gets the post with the given id.
        /// </summary>
        /// <param name="id">The unique post id</param>
        ///
        [Route("jsonpost")]
        public async Task<IActionResult> Post(Guid id)
        {
            var model = await _api.Posts.GetByIdAsync<PostBase>(id);

            return Json(model);
        }
    }
}

https://localhost:60354/api/head/jsonpost?id=1b688882-4b37-490b-a5e1-7f21a09c7b0d