HTTPS Endpoint

GET/https/:url.svg

Path Parameters

urlrequired

Any HTTPS URL that returns JSON with label/value/color fields.

format

variant

size

theme

mode

logo

AutoUpload SVG

logoColor

—

label

flags

split

+Show color overrides

URLMarkdownHTMLrStAsciiDoc

<picture><source media="(prefers-color-scheme: dark)" srcset="https://shieldcn.dev/https/cal-badge-icd0onfvrxx6.runkit.sh.svg?mode=dark"><img alt="badge" src="https://shieldcn.dev/https/cal-badge-icd0onfvrxx6.runkit.sh.svg?mode=light"></picture>

Execute

How it works

Create an HTTPS endpoint on any platform (RunKit, Vercel, Cloudflare Workers, etc.) that returns JSON:

{
  "label": "hello",
  "value": "world",
  "color": "blue"
}

The badgen format is also supported:

{
  "subject": "hello",
  "status": "world",
  "color": "blue"
}

Then use it as a badge:

![badge](https://shieldcn.dev/https/your-endpoint.example.com/path/args)

Path arguments

Any path segments after the hostname are forwarded to the endpoint:

Response format

The endpoint must return JSON with these fields (all optional except value/status):

Examples

Copy-paste examples

Caching

Endpoint responses are cached for 5 minutes.

Credits

This endpoint format is inspired by badgen.net's HTTPS endpoint feature.