SmellBook
Menu

DEVELOPER REFERENCE

A read-only public contract, not a hidden application API.

SmellBook exposes stable discovery, schema and export surfaces for public interoperability while keeping private ranking, personalization and future application internals outside this contract.

SCHEMA VERSION1.0
INVENTORIED RESOURCES102
AUTHNone for public reads
/.well-known/smellbook.json

Discovery document

Canonical machine entry point.

JSON ↗
/data/routes.json

Route index

Public machine and documentation routes.

JSON ↗
/data/contract.json

Compatibility contract

Guarantees, exclusions and versioning rules.

JSON ↗
/data/schema.json

Schema registry

Record-level JSON Schema definitions.

JSON ↗
/data/inventory.json

Data inventory

Formats, media types and record counts.

JSON ↗
NON-GOALS

No user, write or recommendation API is being implied.

This is not the future proprietary SmellBook API. No uptime SLA is promised by this public contract. No write API, user account API or recommendation API is live.