structured data contract audit derived

{
  "input": {
    "body": {
      "url": "https://example.test/widgets/widget-1",
      "html": "<!doctype html><html><head><title>Widget</title><script type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Product\",\"name\":\"Widget\",\"sku\":\"W-1\"},{\"@type\":\"Offer\",\"availability\":\"InStock\"},{\"@type\":\"BreadcrumbList\",\"itemListElement\":[]}]}</script><script type=\"application/ld+json\">{\"@type\":\"WebPage\",\"name\":\"Widget\"}</script></head><body><p>One widget.</p></body></html>",
      "contract": {
        "required_types": [
          "Product",
          "Offer",
          "Organization"
        ],
        "required_properties": {
          "Offer": [
            "price",
            "priceCurrency"
          ],
          "Product": [
            "name",
            "sku",
            "offers"
          ]
        },
        "forbid_unknown_types": true
      }
    },
    "type": "http",
    "method": "POST",
    "bodyType": "json"
  },
  "output": {
    "type": "json",
    "example": {
      "limits": {
        "maxPages": 50,
        "maxListed": 200,
        "maxCookies": 100,
        "maxHeaders": 200,
        "maxFindings": 500,
        "maxHtmlBytes": 262144,
        "maxSitemapUrls": 10000,
        "maxSitemapBytes": 1048576
      },
      "passed": false,
      "complete": true,
      "findings": [
        {
          "code": "REQUIRED_TYPE_ABSENT",
          "type": "Organization",
          "detail": "No Organization entity is declared, and one was required."
        },
        {
          "code": "REQUIRED_PROPERTY_ABSENT",
          "type": "Product",
          "detail": "A Product entity is missing offers.",
          "property": "offers"
        },
        {
          "code": "REQUIRED_PROPERTY_ABSENT",
          "type": "Offer",
          "detail": "A Offer entity is missing price.",
          "property": "price"
        }
      ],
      "conformant": false,
      "request_id": "example-request",
      "service_id": "structured_data_contract_audit",
      "source_url": "https://example.test/widgets/widget-1",
      "assumptions": [
        "A @graph is read as a list of entities, and nested entities are flattened, because reading only the top level would miss every entity a real page declares that way.",
        "Only JSON-LD is read. Microdata and RDFa are not parsed, and a page using them will read as having no structured data, which is stated rather than silently treated as conformant.",
        "The caller supplies the HTML, so nothing is fetched."
      ],
      "block_count": 2,
      "limitations": [
        "Presence and shape of declared structured data. Whether a consumer accepts it, and whether the values are true, are outside this.",
        "conformant is true only when the document was fully parsed and every declared requirement held."
      ],
      "observed_at": "2026-10-02T00:00:00.000Z",
      "entity_count": 4,
      "not_examined": [],
      "finding_count": 7,
      "types_present": [
        "BreadcrumbList",
        "Offer",
        "Product"
      ],
      "required_types": [
        "Product",
        "Offer",
        "Organization"
      ],
      "service_version": "1.0.0",
      "findings_by_code": {
        "UNEXPECTED_TYPE": 2,
        "REQUIRED_TYPE_ABSENT": 1,
        "BLOCK_WITHOUT_CONTEXT": 1,
        "REQUIRED_PROPERTY_ABSENT": 3
      }
    }
  }
}