CONSUMER GUIDE

A small, explicit contract for reading public SmellBook data.

Public machine routes are stateless and read-only. They require no authentication and do not imply a future write, account or recommendation API.

AUTHNone

METHODSGET, HEAD

CORS*

SCHEMA VERSION1.0

EXAMPLES4

Resolve canonical smell ID/data/resolve.json?id=SB-0001Expected 200

Canonical public smell identifier record.

Fetch one smell record/data/smells/rain.jsonExpected 200

One public smell entity record.

Fetch category facet/data/categories/nature.jsonExpected 200

Nature category membership record.

Unknown identifier/data/resolve.json?id=SB-9999Expected 404

Structured unknown_id error.

MACHINE CONTRACTS3

Consumer contract

Methods, CORS, cache, query and compatibility semantics.

Stable public error codes and HTTP statuses.

Representative read-only request/response expectations.