{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "$id": "https://raw.githubusercontent.com/api-evangelist/university-of-the-witwatersrand/main/json-schema/university-of-the-witwatersrand-article-schema.json",
  "title": "Figshare Article",
  "description": "A research output (article/dataset) record from the Figshare public API v2, the platform powering the Wits Open Data Vault. Derived faithfully from the Figshare OpenAPI Article schema.",
  "type": "object",
  "required": [
    "id", "title", "doi", "handle", "url", "url_public_html", "url_public_api",
    "url_private_html", "url_private_api", "timeline", "thumb", "defined_type",
    "defined_type_name", "resource_doi", "resource_title", "created_date"
  ],
  "properties": {
    "id": { "type": "integer", "description": "Unique identifier for article", "examples": [1434614] },
    "title": { "type": "string", "description": "Title of article" },
    "doi": { "type": "string", "description": "DOI", "examples": ["10.6084/m9.figshare.1434614"] },
    "handle": { "type": "string", "description": "Handle" },
    "url": { "type": "string", "format": "uri", "description": "API endpoint for article" },
    "url_public_html": { "type": "string", "format": "uri", "description": "Public site endpoint for article" },
    "url_public_api": { "type": "string", "format": "uri", "description": "Public API endpoint for article" },
    "url_private_html": { "type": "string", "format": "uri", "description": "Private site endpoint for article" },
    "url_private_api": { "type": "string", "format": "uri", "description": "Private API endpoint for article" },
    "timeline": { "$ref": "#/definitions/timeline" },
    "thumb": { "type": "string", "format": "uri", "description": "Thumbnail image" },
    "defined_type": { "type": "integer", "description": "Type of article identifier" },
    "defined_type_name": { "type": "string", "description": "Name of the article type identifier" },
    "resource_doi": { "type": "string", "description": "Publisher article DOI (publisher case)." },
    "resource_title": { "type": "string", "description": "Publisher article title (publisher case)." },
    "created_date": { "type": "string", "format": "date-time", "description": "Date when article was created" }
  },
  "definitions": {
    "timeline": {
      "type": "object",
      "description": "Event timestamps for the article.",
      "properties": {
        "posted": { "type": "string", "format": "date-time" },
        "firstOnline": { "type": "string", "format": "date-time" },
        "revision": { "type": "string", "format": "date-time" }
      }
    }
  }
}