DealerPublicContentDetailResponse

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/dealermax-app/json-schema/dealermax-app-dealer-public-content-detail-response-schema.json",
  "title": "DealerPublicContentDetailResponse",
  "description": "Detail envelope for a single editorial content item.",
  "x-generated": "2026-11-05",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/dealermax-app-openapi.json#/components/schemas/DealerPublicContentDetailResponse",
  "type": "object",
  "required": [
    "content_type",
    "item"
  ],
  "properties": {
    "content_type": {
      "type": "string",
      "enum": [
        "faq",
        "news",
        "glossary",
        "guides",
        "videos",
        "podcasts"
      ],
      "description": "Editorial content type of the item (news, guides, glossary or faq). Deprecated for `guides` and `glossary`: those dealer pages are retired and now 301-redirect to https://autousatebenissimo.it, which hosts the same corpus at the same paths. The data stays served until the Sunset date announced in the response headers (Deprecation as an RFC 9745 structured Date, Sunset as an RFC 8594 HTTP-date, and Link with rel=sunset plus rel=successor-version); listing and detail payloads of those two types also carry `deprecated`, `deprecation`, `sunset` and `successor_version`."
    },
    "item": {
      "$ref": "#/$defs/DealerPublicContentItem"
    },
    "deprecated": {
      "type": "boolean",
      "description": "Present and true only for the retired `guides` / `glossary` types."
    },
    "deprecation": {
      "type": "string",
      "description": "RFC 9745 structured Date (`@<unix-timestamp>`) at which the deprecation took effect."
    },
    "sunset": {
      "type": "string",
      "description": "HTTP-date after which a deprecated content type may stop being served."
    },
    "successor_version": {
      "type": "string",
      "format": "uri",
      "description": "Canonical home of the corpus for a deprecated content type."
    },
    "meta": {
      "type": "object",
      "additionalProperties": true,
      "description": "Identifying metadata about the dealer that owns the returned content.",
      "properties": {
        "dealer": {
          "type": "object",
          "additionalProperties": true,
          "description": "The dealer the content belongs to.",
          "properties": {
            "id": {
              "type": "integer",
              "description": "Internal dealer id."
            },
            "name": {
              "type": "string",
              "description": "Dealer legal/registered name."
            },
            "brand_name": {
              "type": "string",
              "description": "Dealer commercial brand name, as shown to end users."
            },
            "city": {
              "type": "string",
              "description": "Dealer city."
            },
            "province": {
              "type": "string",
              "description": "Dealer province (Italian two-letter code, e.g. 'MI')."
            },
            "primary_domain": {
              "type": "string",
              "description": "Dealer primary public website domain."
            }
          }
        }
      }
    }
  },
  "$defs": {
    "DealerPublicContentItem": {
      "type": "object",
      "additionalProperties": true,
      "description": "One editorial content item (news, guide, glossary term or FAQ) published on the dealer site.",
      "properties": {
        "id": {
          "type": "integer",
          "description": "Internal content item id."
        },
        "slug": {
          "type": "string",
          "description": "URL-friendly unique slug identifying the content item."
        },
        "topic": {
          "type": "string",
          "description": "Topic / category the content item belongs to."
        },
        "title": {
          "type": "string",
          "description": "Content title."
        },
        "h1": {
          "type": "string",
          "description": "Page H1 heading (may differ from the title)."
        },
        "meta_description": {
          "type": "string",
          "description": "SEO meta description for the content page."
        },
        "excerpt": {
          "type": "string",
          "description": "Short summary/teaser of the content."
        },
        "body_text_preview": {
          "type": "string",
          "description": "Plain-text preview of the body (truncated; full body served on the dealer site)."
        },
        "source_provider": {
          "type": "string",
          "description": "News editions only: provenance class. dealer_editorial identifies first-party local editions; historical/external editions remain readable but are excluded from discovery."
        },
        "url": {
          "type": "string",
          "format": "uri",
          "description": "Absolute URL of the content page on the dealer site."
        },
        "updated_at": {
          "type": "string",
          "format": "date-time",
          "description": "Timestamp of the last content update (ISO 8601)."
        }
      }
    }
  }
}