Schemas / Book

rig.book.identifier

v0.31.0 · draft 4 fields 0 required

Fields

FieldTypeMeaning
isbn13 string optional 13 digits, no hyphens or spaces
isbn10 string optional 9 digits plus check digit or X
doi string optional Digital Object Identifier
issn string optional NNNN-NNNC

Product identifiers of a book (or other ONIX product). Format when present.

ISBN meaning follows ISO 2108. Other slots follow ONIX for Books ProductIdentifier. This schema is those identifiers - not an ONIX message and not a title.

All fields optional. Emit what the source has. An empty component is invalid - attach at least one field.

Prefer isbn13 when the source has one. The importer strips hyphens. Do not invent isbn10 by converting isbn13, and do not store a GTIN-13 that is the same ISBN under a second key.

The distinctive title is rig.meta.named. Subtitle and edition are rig.book.title.

JSON Schema

Resolves at https://rig.works/schemas/rig.book.identifier.schema.jsonraw file.

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://rig.works/schemas/rig.book.identifier.schema.json",
  "title": "rig.book.identifier",
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "isbn13": {
      "type": "string",
      "pattern": "^97[89][0-9]{10}$",
      "description": "ISO 2108 ISBN-13 digits only (ONIX ProductIDType 15)."
    },
    "isbn10": {
      "type": "string",
      "pattern": "^[0-9]{9}[0-9X]$",
      "description": "ISO 2108 ISBN-10 (ONIX ProductIDType 02). Legacy."
    },
    "doi": {
      "$ref": "./_defs.schema.json#/$defs/string"
    },
    "issn": {
      "type": "string",
      "pattern": "^[0-9]{4}-[0-9]{3}[0-9X]$",
      "description": "ISSN (ISO 3297)."
    }
  },
  "description": "Product identifiers. Prefer isbn13 (ISO 2108). Do not invent isbn10 from isbn13.",
  "minProperties": 1
}

Seen in

book-isbn.json · commerce-offer.json · paper-citation.json