Deals API 1.0 JSON Schema Unofficial

Decision records ·

D-027 Which AdCOM list do devicetype and cattax take, when the text links List: Device Type and List: Category Taxonomies on AdCOM's main?

Gap Cited on main and at the tag 1.0-202602.

What the schemas do

AdCOM 1.0's List: Device Types and List: Category Taxonomies, at the commit this site's registry pins, by reference to the registry's lists, so the schema copies none of their codes.

Options

  • pinned-registry Chosen

    AdCOM 1.0's List: Device Types and List: Category Taxonomies, at the commit this site's registry pins, by reference to the registry's lists, so the schema copies none of their codes.

  • latest

    Whatever AdCOM's main holds when the deal is read, as the links point.

Why

The links point at AdCOM's main, which changes inside 1.0, so the codes a deal may send would move with it. The schema takes both lists from the registry at its pinned commit, by reference, and the link's "Device Type" names the list AdCOM titles Device Types, whose anchor it links.

What we ask the specification to state

Link AdCOM at a release or a commit, so a deal's devicetype and cattax codes don't change when AdCOM's main does; and write the list's title, "List: Device Types".

The specification lines it rests on

Each line is quoted as the record pins it. Expand an item to read the quote.

main

  • Object: Inventory, the devicetype row L127 at 3028ddc
    devicetype | integer array | The general type of device. Refer to List: Device Type in AdCOM 1.0
  • Object: Inventory, the cattax row L132 at 3028ddc
    cattax | integer | The taxonomy in use for the cat attribute. Refer to List: Category Taxonomies.

Tag 1.0-202602

  • Object: Inventory, the devicetype row L127 at 938a5d1
    devicetype | integer array | The general type of device. Refer to List: Device Type in AdCOM 1.0
  • Object: Inventory, the cattax row L132 at 938a5d1
    cattax | integer | The taxonomy in use for the cat attribute. Refer to List: Category Taxonomies.

What it shapes

main: CategoryTaxonomy, DeviceType, Inventory.cattax, Inventory.devicetype

Tag 1.0-202602: CategoryTaxonomy, DeviceType, Inventory.cattax, Inventory.devicetype

The record's YAML file