| filename |
string |
Optional filename, used as a title fallback when no /<h1> is present. Immutable on update.</td>
</tr>
<tr>
<td><span class="prop-name">format</span></td>
<td><span class="prop-type">string</span></td>
<td>Storage format. `markdown` is rendered to styled HTML at view time.</td>
</tr>
<tr>
<td><span class="prop-name">tags</span></td>
<td><span class="prop-type">array</span></td>
<td>Free-form tags supplied at creation time.</td>
</tr>
<tr>
<td><span class="prop-name">ttlDays</span></td>
<td><span class="prop-type">integer</span></td>
<td>Time-to-live in days. Default 15, max 30.</td>
</tr>
<tr>
<td><span class="prop-name">passwordProtected</span></td>
<td><span class="prop-type">boolean</span></td>
<td>True if an X-Password is required to read the resource.</td>
</tr>
<tr>
<td><span class="prop-name">showTopBar</span></td>
<td><span class="prop-type">boolean</span></td>
<td>When true, the served page includes a toolbar (filename, download, theme toggle).</td>
</tr>
<tr>
<td><span class="prop-name">createdAt</span></td>
<td><span class="prop-type">string</span></td>
<td></td>
</tr>
<tr>
<td><span class="prop-name">expiresAt</span></td>
<td><span class="prop-type">string</span></td>
<td></td>
</tr>
<tr>
<td><span class="prop-name">views</span></td>
<td><span class="prop-type">integer</span></td>
<td></td>
</tr>
</tbody>
</table>
</div>
<div style="margin-top: 2rem;">
<a href="https://github.com/api-evangelist/brewpage/blob/main/json-schema/brewpage-html-page-schema.json" target="_blank" rel="noopener" class="btn btn-outline-dark btn-sm">View JSON Schema on GitHub</a>
</div>
<link rel="stylesheet" href="/assets/prism/prism-coy.min.css">
<link rel="stylesheet" href="/assets/prism/prism-line-numbers.min.css">
<style>
.src-widget { background: #fdfdfd; border: 1px solid #e3e7ee; border-radius: 10px; overflow: hidden; margin-top: 0.75rem; }
.src-widget-head { display: flex; align-items: center; gap: 0.5rem; padding: 0.55rem 0.85rem; background: #f8fafc; border-bottom: 1px solid #e3e7ee; flex-wrap: wrap; }
.src-label { color: #475569; font-weight: 600; font-family: ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, monospace; font-size: 0.8rem; flex: 0 0 auto; }
.src-picker { flex: 0 0 auto; max-width: 360px; padding: 0.3em 0.55em; border: 1px solid #cbd5e1; border-radius: 4px; background: #fff; font-size: 0.78rem; color: #1a1a2e; font-family: ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, monospace; cursor: pointer; }
.src-picker:focus { outline: none; border-color: #1e40af; box-shadow: 0 0 0 2px rgba(30, 64, 175, 0.15); }
.src-loading { color: #94a3b8; font-style: italic; padding: 1rem; }
.src-search { flex: 1 1 200px; min-width: 140px; }
.src-search input { width: 100%; padding: 0.3em 0.6em; border: 1px solid #cbd5e1; border-radius: 4px; font-size: 0.8rem; background: #fff; color: #1a1a2e; }
.src-search input:focus { outline: none; border-color: #1e40af; box-shadow: 0 0 0 2px rgba(30, 64, 175, 0.15); }
.src-actions { display: flex; gap: 0.25rem; flex: 0 0 auto; }
.src-actions a, .src-actions button { background: none; border: 1px solid transparent; padding: 0.25em 0.6em; color: #1e40af; font-size: 0.78rem; font-weight: 500; cursor: pointer; text-decoration: none; border-radius: 4px; line-height: 1.4; }
.src-actions a:hover, .src-actions button:hover { background: #eef2f7; }
.src-actions button.active { background: #dbeafe; border-color: #93c5fd; }
.src-actions button:disabled { color: #94a3b8; cursor: not-allowed; }
.src-actions button:disabled:hover { background: none; }
.src-widget pre[class*="language-"] { margin: 0; padding: 1rem 0; background: #fdfdfd; box-shadow: none; border: none; max-height: 540px; overflow: auto; font-size: 0.82rem; line-height: 1.5; }
.src-widget pre[class*="language-"] > code { font-family: ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, monospace; padding-right: 1rem; }
.src-widget pre[class*="language-"]::before, .src-widget pre[class*="language-"]::after { display: none; }
.src-widget pre.line-numbers { padding-left: 3.5em; counter-reset: linenumber; position: relative; }
.src-widget pre.line-numbers > code { position: relative; white-space: inherit; }
.src-widget pre.line-numbers .line-numbers-rows { position: absolute; pointer-events: none; top: 1rem; font-size: 100%; left: -3em; width: 2.7em; letter-spacing: -1px; border-right: 1px solid #e3e7ee; user-select: none; }
.src-widget pre.line-numbers .line-numbers-rows > span { display: block; counter-increment: linenumber; }
.src-widget pre.line-numbers .line-numbers-rows > span:before { content: counter(linenumber); color: #cbd5e1; display: block; padding-right: 0.7em; text-align: right; font-size: 0.78rem; }
.src-widget .token.key, .src-widget .token.property, .src-widget .token.atrule { color: #1e40af; font-weight: 600; }
.src-widget .token.string { color: #047857; }
.src-widget .token.number, .src-widget .token.boolean, .src-widget .token.null { color: #b45309; }
.src-widget .token.comment { color: #94a3b8; font-style: italic; }
.src-widget .token.punctuation, .src-widget .token.operator { color: #64748b; }
.src-widget .token.tag { color: #7c3aed; }
.src-widget .token.anchor, .src-widget .token.alias { color: #be185d; }
.src-widget mark.src-hit { background: #fef08a; color: inherit; padding: 0; border-radius: 2px; }
.src-widget mark.src-hit-active { background: #fb923c; color: #fff; }
.src-copied { color: #047857 !important; }
.src-empty { padding: 2rem 1rem; text-align: center; color: #94a3b8; font-size: 0.85rem; }
</style>
<h3 class="section-title" id="source">JSON Schema</h3>
<div class="src-widget" data-src-widget data-original-lang="json" data-current-lang="json" data-original-filename="brewpage-html-page-schema.json">
<div class="src-widget-head">
<span class="src-label" data-src-filename>brewpage-html-page-schema.json</span>
<span class="src-search">
<input type="search" data-src-search placeholder="Search in source… (n / N to navigate)" aria-label="Search source">
</span>
<span class="src-actions">
<button type="button" data-src-toggle data-target="yaml" aria-label="View as YAML">YAML</button>
<button type="button" data-src-toggle data-target="json" aria-label="View as JSON">JSON</button>
<button type="button" data-src-download aria-label="Download source">Download</button>
<a data-src-raw href="https://raw.githubusercontent.com/api-evangelist/brewpage/refs/heads/main/json-schema/brewpage-html-page-schema.json" target="_blank" rel="noopener">Raw ↑</a>
<button type="button" data-src-copy>Copy</button>
</span>
</div>
<pre class="line-numbers language-json"><code class="language-json" data-src-code>{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://raw.githubusercontent.com/api-evangelist/brewpage/main/json-schema/brewpage-html-page-schema.json",
"title": "BrewPage HTML Page",
"description": "An HTML or Markdown page hosted on BrewPage. Created via POST /api/html and addressable at the short URL /{ns}/{id}.",
"type": "object",
"required": ["id", "namespace", "link", "ownerToken"],
"properties": {
"id": {
"type": "string",
"minLength": 10,
"maxLength": 10,
"description": "10-char short identifier assigned by the server."
},
"namespace": {
"type": "string",
"pattern": "^[a-z0-9-]{1,32}$",
"description": "Logical bucket the page lives under. Defaults to `public` when omitted."
},
"link": {
"type": "string",
"format": "uri",
"description": "Short, shareable URL of the page: https://brewpage.app/{ns}/{id}."
},
"ownerLink": {
"type": "string",
"format": "uri",
"description": "Owner API URL used for updates/deletes."
},
"ownerToken": {
"type": "string",
"description": "Bearer-style owner token returned at creation. Sent as `X-Owner-Token` for mutation."
},
"filename": {
"type": "string",
"maxLength": 200,
"description": "Optional filename, used as a title fallback when no <title>/<h1> is present. Immutable on update."
},
"format": {
"type": "string",
"enum": ["html", "markdown", "md"],
"description": "Storage format. `markdown` is rendered to styled HTML at view time."
},
"tags": {
"type": "array",
"items": {"type": "string"},
"description": "Free-form tags supplied at creation time."
},
"ttlDays": {
"type": "integer",
"minimum": 1,
"maximum": 30,
"description": "Time-to-live in days. Default 15, max 30."
},
"passwordProtected": {
"type": "boolean",
"description": "True if an X-Password is required to read the resource."
},
"showTopBar": {
"type": "boolean",
"description": "When true, the served page includes a toolbar (filename, download, theme toggle)."
},
"createdAt": {"type": "string", "format": "date-time"},
"expiresAt": {"type": "string", "format": "date-time"},
"views": {"type": "integer", "minimum": 0}
},
"additionalProperties": false
}
</code></pre>
</div>
<script src="/assets/prism/prism-core.min.js" defer></script>
<script src="/assets/prism/prism-yaml.min.js" defer></script>
<script src="/assets/prism/prism-json.min.js" defer></script>
<script src="/assets/prism/prism-line-numbers.min.js" defer></script>
<script src="/assets/prism/js-yaml.min.js" defer></script>
<script>
(function () {
if (window.__srcWidgetInit) return;
window.__srcWidgetInit = true;
function initWidget(widget) {
var codeEl = widget.querySelector('[data-src-code]');
var preEl = widget.querySelector('pre');
var search = widget.querySelector('[data-src-search]');
var toggles = widget.querySelectorAll('[data-src-toggle]');
var downloadBtn = widget.querySelector('[data-src-download]');
var copyBtn = widget.querySelector('[data-src-copy]');
var fileLabel = widget.querySelector('[data-src-filename]');
var picker = widget.querySelector('[data-src-picker]');
var rawLink = widget.querySelector('[data-src-raw]');
var headingEl = widget.previousElementSibling && widget.previousElementSibling.tagName === 'H3'
? widget.previousElementSibling : null;
var fetchedCache = {};
// Original raw text — we always re-render from this so toggles + searches don't compound.
var originalLang = widget.dataset.originalLang;
var originalText = codeEl.textContent;
var originalFilename = widget.dataset.originalFilename;
var currentLang = originalLang;
var currentText = originalText;
var searchHits = [];
var activeHit = -1;
function highlight() {
if (window.Prism) window.Prism.highlightElement(codeEl);
}
function setActiveToggle() {
toggles.forEach(function (b) {
if (b.dataset.target === currentLang) b.classList.add('active');
else b.classList.remove('active');
});
}
function updateFilenameForLang() {
if (!fileLabel) return;
var base = (currentSourceFilename || originalFilename).replace(/\.(ya?ml|json)$/i, '');
fileLabel.textContent = base + '.' + currentLang;
}
var currentSourceFilename = originalFilename;
var currentSourceUrl = null;
if (rawLink) currentSourceUrl = rawLink.getAttribute('href');
function setLangContent(lang, text) {
currentLang = lang;
currentText = text;
codeEl.textContent = text;
codeEl.className = 'language-' + lang;
preEl.className = 'line-numbers language-' + lang;
highlight();
setActiveToggle();
updateFilenameForLang();
runSearch();
}
function tryConvert(targetLang) {
if (targetLang === currentLang) return;
if (!window.jsyaml) return;
try {
var parsed;
if (currentLang === 'yaml') parsed = window.jsyaml.load(currentText);
else parsed = JSON.parse(currentText);
var out;
if (targetLang === 'yaml') {
out = window.jsyaml.dump(parsed, { indent: 2, lineWidth: 100, noRefs: true });
} else {
out = JSON.stringify(parsed, null, 2);
}
setLangContent(targetLang, out);
} catch (err) {
alert('Cannot convert: source is not valid ' + currentLang.toUpperCase() + '.\n' + err.message);
}
}
// ---- Search highlighting (DOM walker over text nodes inside <code>) ----
function clearSearch() {
widget.querySelectorAll('mark.src-hit').forEach(function (m) {
var parent = m.parentNode;
while (m.firstChild) parent.insertBefore(m.firstChild, m);
parent.removeChild(m);
parent.normalize();
});
searchHits = [];
activeHit = -1;
}
function runSearch() {
clearSearch();
var q = (search.value || '').trim();
if (q.length < 2) return;
var qLower = q.toLowerCase();
var walker = document.createTreeWalker(codeEl, NodeFilter.SHOW_TEXT, null);
var nodes = [];
var n;
while ((n = walker.nextNode())) nodes.push(n);
nodes.forEach(function (node) {
var text = node.nodeValue;
var lower = text.toLowerCase();
var idx = lower.indexOf(qLower);
if (idx === -1) return;
var frag = document.createDocumentFragment();
var cursor = 0;
while (idx !== -1) {
if (idx > cursor) frag.appendChild(document.createTextNode(text.slice(cursor, idx)));
var mark = document.createElement('mark');
mark.className = 'src-hit';
mark.textContent = text.slice(idx, idx + q.length);
frag.appendChild(mark);
searchHits.push(mark);
cursor = idx + q.length;
idx = lower.indexOf(qLower, cursor);
}
if (cursor < text.length) frag.appendChild(document.createTextNode(text.slice(cursor)));
node.parentNode.replaceChild(frag, node);
});
if (searchHits.length) jumpToHit(0);
}
function jumpToHit(i) {
if (!searchHits.length) return;
if (activeHit >= 0 && searchHits[activeHit]) searchHits[activeHit].classList.remove('src-hit-active');
activeHit = ((i % searchHits.length) + searchHits.length) % searchHits.length;
var el = searchHits[activeHit];
el.classList.add('src-hit-active');
el.scrollIntoView({ block: 'center', behavior: 'smooth' });
}
// ---- Wire up ----
var debounce;
search.addEventListener('input', function () {
clearTimeout(debounce);
debounce = setTimeout(runSearch, 100);
});
search.addEventListener('keydown', function (ev) {
if (ev.key === 'Enter' || ev.key === 'n') { ev.preventDefault(); jumpToHit(activeHit + 1); }
else if (ev.key === 'N' || (ev.key === 'p')) { ev.preventDefault(); jumpToHit(activeHit - 1); }
else if (ev.key === 'Escape') { search.value = ''; runSearch(); }
});
toggles.forEach(function (b) {
b.addEventListener('click', function () { tryConvert(b.dataset.target); });
});
downloadBtn.addEventListener('click', function () {
var blob = new Blob([codeEl.textContent], { type: currentLang === 'json' ? 'application/json' : 'application/yaml' });
var url = URL.createObjectURL(blob);
var a = document.createElement('a');
a.href = url;
a.download = fileLabel.textContent;
document.body.appendChild(a);
a.click();
document.body.removeChild(a);
setTimeout(function () { URL.revokeObjectURL(url); }, 0);
});
copyBtn.addEventListener('click', function () {
navigator.clipboard.writeText(codeEl.textContent).then(function () {
var orig = copyBtn.textContent;
copyBtn.textContent = 'Copied';
copyBtn.classList.add('src-copied');
setTimeout(function () { copyBtn.textContent = orig; copyBtn.classList.remove('src-copied'); }, 1500);
});
});
// ---- Picker (provider pages with multiple specs) ----
function applySource(text, lang, filename, url, heading) {
currentSourceFilename = filename || originalFilename;
currentSourceUrl = url || null;
if (rawLink) {
if (url) { rawLink.setAttribute('href', url); rawLink.style.display = ''; }
else { rawLink.style.display = 'none'; }
}
if (headingEl && heading) headingEl.textContent = heading;
setLangContent(lang, text);
}
if (picker) {
picker.addEventListener('change', function () {
var opt = picker.options[picker.selectedIndex];
var url = opt.dataset.url;
var fmt = opt.dataset.format || 'yaml';
var fname = opt.dataset.filename || '';
var heading = opt.dataset.heading || '';
if (!url) {
// Original embedded source
applySource(originalText, originalLang, originalFilename, picker.options[0].dataset.url || null, picker.options[0].dataset.heading || '');
return;
}
if (fetchedCache[url]) {
applySource(fetchedCache[url], fmt, fname, url, heading);
return;
}
codeEl.textContent = 'Loading ' + fname + '…';
codeEl.className = '';
preEl.className = '';
fetch(url).then(function (r) {
if (!r.ok) throw new Error('HTTP ' + r.status);
return r.text();
}).then(function (text) {
fetchedCache[url] = text;
applySource(text, fmt, fname, url, heading);
}).catch(function (err) {
codeEl.textContent = 'Could not load: ' + err.message;
});
});
// Stash the default option's url so we can restore "Raw" link when reset.
if (rawLink && picker.options[0]) {
picker.options[0].dataset.url = rawLink.getAttribute('href') || '';
picker.options[0].dataset.heading = (headingEl ? headingEl.textContent : '') || '';
}
}
// Auto-fetch when initial source is empty but a remote URL is available.
// This happens when the build found an external OpenAPI URL but didn't
// inline the content — the widget fetches it on page load instead.
if (!originalText.trim() && currentSourceUrl) {
var remoteUrl = currentSourceUrl;
codeEl.textContent = 'Loading…';
codeEl.className = '';
preEl.className = 'line-numbers language-' + originalLang;
fetch(remoteUrl)
.then(function (r) { if (!r.ok) throw new Error('HTTP ' + r.status); return r.text(); })
.then(function (text) {
var ext = remoteUrl.replace(/\?.*/, '').split('.').pop().toLowerCase();
var fmt = ext === 'json' ? 'json' : 'yaml';
originalText = text;
originalLang = fmt;
currentLang = fmt;
widget.dataset.originalLang = fmt;
applySource(text, fmt, originalFilename, remoteUrl, headingEl ? headingEl.textContent : '');
})
.catch(function (err) {
codeEl.textContent = 'Could not load spec: ' + err.message;
});
}
// Initial state
setActiveToggle();
// Wait for Prism to load before highlighting / line-numbers wiring.
var tries = 0;
var waitPrism = setInterval(function () {
if (window.Prism && window.Prism.plugins) {
clearInterval(waitPrism);
highlight();
} else if (++tries > 80) {
clearInterval(waitPrism);
}
}, 50);
}
function initAll() {
document.querySelectorAll('[data-src-widget]').forEach(initWidget);
}
if (document.readyState === 'loading') {
document.addEventListener('DOMContentLoaded', initAll);
} else {
initAll();
}
})();
</script>
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "BreadcrumbList",
"itemListElement": [
{
"@type": "ListItem",
"position": 1,
"name": "Home",
"item": "https://apis.io/"
},
{
"@type": "ListItem",
"position": 2,
"name": "BrewPage",
"item": "https://providers.apis.io/providers/brewpage/"
},
{
"@type": "ListItem",
"position": 3,
"name": "BrewPage HTML Page"
}
]
}
</script>
</main>
<footer class="footer">
<div class="container">
<div class="d-flex justify-content-center gap-4 align-items-center" style="height: 60px;">
<a href="http://apisjson.org">APIs.json</a>
<a href="http://apicommons.org">API Commons</a>
<a href="https://developer.apis.io">Developers</a>
<a href="https://github.com/api-search">GitHub</a>
</div>
</div>
</footer>
</body>
</html>
|