SplatDev.Umbraco.Plugins.JsonRpc 2.2.4

JsonRpc

JSON-RPC 2.0 API endpoint for Umbraco — expose content as JSON-RPC with API key management and request logging. Supports Umbraco 13 (net8.0) and Umbraco 17 (net10.0).

Compatibility

Installation

dotnet add package SplatDev.Umbraco.Plugins.JsonRpc

Quick Start

Register in Program.cs:

builder.CreateUmbracoBuilder()
    .AddBackOffice()
    .AddWebsite()
    .AddJsonRpc()   // <-- add this
    .Build();

Configuration

Add to appsettings.json:

{
  "JsonRpc": {
    "ApiKeys": [ "" ],
    "EnableRequestLogging": true
  }
}

U17 Bellissima Dashboard (Lit)

The U17 dashboard is built as a Lit Web Component using Vite and TypeScript.

Development

cd client
npm install  # or pnpm install
npm run dev  # watch mode during development
npm run build  # production build

The build output is placed at App_Plugins/JsonRpc/dist/jsonrpc-dashboard.element.js and registered in umbraco-package.json.

Architecture

• client/ — Vite + TypeScript + Lit source
• client/src/jsonrpc-dashboard.element.ts — Lit element showing JSON-RPC status and endpoints
• Controllers/ — JSON-RPC 2.0 handler endpoints
• Services/ — API key management and request logging

Changelog

2.2.4 — 2026-08-24

Removes a dashboard screenshot that showed an error toast. It was captured against a site where this plugin's API was unreachable, so it advertised a broken dashboard. No screenshot is better than a misleading one; a replacement will be taken against a working install.

2.2.3 — 2026-08-24

Package metadata only: the listing now carries an icon and search tags, and the project and repository links point at the organisation that actually hosts this code. No code changes.

2.2.2 — 2026-08-21

• API keys can be managed from the dashboard — list, create and revoke. It previously made no requests at all.
• A newly created key is returned as its own result with a rawKey field, shown once. It used to be smuggled back inside the entity's Name as "name||RAW:key", which every caller had to parse and which was one accidental re-save away from writing a live key into the database in plain text.
• A failed request now says so instead of leaving an empty list.

2.2.1 — 2026-08-21

• The plugin's tables are created on startup. They were never created before, so anything touching them failed on a fresh install.
• Runs on SQLite as well as SQL Server. It previously assumed SQL Server and failed with "Keyword not supported: 'cache'" on the database Umbraco's installer offers by default.

License

MIT © SplatDev