The Device API

Design only · no hardware · nothing executes A proposed standard way to write down a scent instruction (which components, in what proportions, when and how strongly), derived only from the public teaching accords. No device implements it; it never carries a Radler formula or any real perfume’s composition.

What it is

• A JSON Schema (draft 2020-12) for a scent instruction: /data/device-api/schema.json.
• Derived from public records only. The source must be a teaching accord (source.purpose is always “teaching”); each channel names a component by its record id, with its PubChem CID where the record has one, so any reader can follow it back to its sources.
• Proportion, timing, intensity. Each channel carries the component’s modeled teaching share, its volatility class (from the records, or modeled and saying so), a timing envelope for a one-minute demonstration (modeled: the top arrives first, the base last) and a relative intensity (its share against the largest; proportion, not perceived strength). A timeline of keyframes gives every channel’s level every five seconds.
• Safety fields that cannot be switched on. safety.for_skin and safety.assessed are always false; the regulation records the accord names are listed for reading. IFRA Standards are the industry’s own standards and are not law in the US; EU rules apply in the EU.
• Why. Devices that release scent on command are being researched (the house’s vision notes wearables); a shared, open description of what to release, tied to sourced records, is a small, useful layer that needs no hardware to write down. This page offers one; it is a draft for discussion.

One instruction: the rose teaching accord

{
  "format": "radler-scent-instruction",
  "version": "0.1.0",
  "status": "design draft: no device implements this, and nothing executes it",
  "source": {
    "type": "Accord",
    "id": "rose-teaching-accord",
    "record_version": 2,
    "url": "https://www.radlerparfums.com/accord/rose-teaching-accord",
    "data": "https://www.radlerparfums.com/data/accord/rose-teaching-accord.json",
    "purpose": "teaching",
    "licence": "https://creativecommons.org/licenses/by/4.0/"
  },
  "disclaimer": "A teaching accord for learning: not a Radler formula, not a finished perfume, not safety-assessed; do not make it for skin.",
  "units": {
    "time": "seconds from the start of the instruction",
    "proportion": "share of the accord, 0 to 1 (modeled teaching share)",
    "intensity": "relative, 0 to 1: the channel's share against the largest share (proportion, not perceived strength)"
  },
  "channels": [
    {
      "channel": 1,
      "component": {
        "type": "Molecule",
        "id": "phenylethyl-alcohol",
        "name": "2-phenylethyl alcohol",
        "pubchem_cid": 6054,
        "url": "https://www.radlerparfums.com/molecule/phenylethyl-alcohol"
      },
      "proportion": 0.45,
      "volatility_class": "heart",
      "class_from": "its role in the accord (documented)",
      "envelope": {
        "onset_s": 8,
        "attack_s": 6,
        "hold_s": 24,
        "release_s": 20
      },
      "intensity": 1
    },
    "…"
  ],
  "timeline": [
    {
      "t_s": 0,
      "levels": [
        0,
        0,
        0,
        0
      ]
    },
    {
      "t_s": 5,
      "levels": [
        0,
        0,
        0,
        0
      ]
    },
    "…"
  ],
  "safety": {
    "for_skin": false,
    "assessed": false,
    "regulation_refs": [
      "ifra-rose-ketones",
      "eu-2009-1223",
      "eu-2023-1545"
    ],
    "note": "A teaching accord for learning, not a finished product; IFRA Standards are the industry's own standards (not law in the US); EU regulation applies in the EU. Read each regulation record for its jurisdiction."
  }
}

Every field

An instruction for every teaching accord

Generated from the records at every build and checked against the schema; a build fails if one does not validate.

• An amber (/data/device-api/examples/amber-teaching-accord.json)
• The chypre skeleton (/data/device-api/examples/chypre-teaching-accord.json)
• A cologne (/data/device-api/examples/cologne-teaching-accord.json)
• The fougère skeleton (/data/device-api/examples/fougere-teaching-accord.json)
• A muguet (/data/device-api/examples/muguet-teaching-accord.json)
• A rose, from four molecules (/data/device-api/examples/rose-teaching-accord.json)
• A white floral, indolic (/data/device-api/examples/white-floral-teaching-accord.json)
• A woody-ambery (/data/device-api/examples/woody-ambery-teaching-accord.json)

The Olfactory Genome · The Spatial Sillage Lab · The rose teaching accord · The teaching accords

This page’s data is published under CC BY 4.0: /data/device-api/schema.json.

schema version 0.1.0 · updated 2026-09-30