{
  "interface_version": "1.0",
  "name": "TechSpecs Machine Retrieval Interface",
  "purpose": "machine_readability",
  "access": {
    "mode": "read_only",
    "allowed_methods": [
      "GET"
    ],
    "authentication_required": false
  },
  "canonical_data_host": "https://data.techspecs.dev",
  "discovery_order": [
    "https://data.techspecs.dev/api-manifest.json",
    "https://data.techspecs.dev/catalogue.json",
    "https://data.techspecs.dev/schemas/product-record-v2.schema.json"
  ],
  "resources": {
    "catalogue": {
      "url": "https://data.techspecs.dev/catalogue.json",
      "format": "application/json",
      "description": "Authoritative index of published product records and their canonical URLs."
    },
    "product_record_schema": {
      "url": "https://data.techspecs.dev/schemas/product-record-v2.schema.json",
      "format": "application/schema+json",
      "description": "JSON Schema describing the product record structure."
    },
    "machine_reading_instructions": {
      "url": "https://data.techspecs.dev/llms.txt",
      "format": "text/plain",
      "description": "Instructions for AI systems and other automated readers."
    },
    "sitemap": {
      "url": "https://data.techspecs.dev/sitemap.xml",
      "format": "application/xml",
      "description": "Published machine-readable resource URLs."
    },
    "versioned_product_endpoint": {
      "url": "https://data.techspecs.dev/api/v1/products/{product-id}.json",
      "method": "GET",
      "format": "application/json",
      "description": "Versioned static product record route. Replace {product-id} with the exact record filename stem supplied by the catalogue."
    }
  },
  "record_retrieval": {
    "method": "GET",
    "discovery_source": "catalogue.records[].url",
    "url_pattern": "https://data.techspecs.dev/api/v1/products/{product-id}.json",
    "rule": "Use the exact URL supplied by the catalogue. The versioned route is a static rewrite to the published source record. Do not infer record URLs or assume an unlisted product exists.",
    "response_format": "application/json",
    "record_schema": "https://data.techspecs.dev/schemas/product-record-v2.schema.json",
    "legacy_url_field": "catalogue.records[].legacy_url"
  },
  "interpretation": {
    "provenance": "Use each record's source object and retained sections to distinguish source evidence from normalized fields.",
    "verification": "Verification status describes the checks recorded for a field or source; it is not a blanket guarantee.",
    "missing_values": "Do not infer values for missing, null, unknown, unverified or not-applicable fields.",
    "derived_values": "Treat derived values as derived only where the record explicitly identifies their method and inputs."
  },
  "limitations": [
    "This is a static, read-only data interface, not a dynamic query API.",
    "Search and filtering are performed by retrieving and processing the catalogue and records.",
    "No write, submission, update or deletion operations are exposed."
  ],
  "canonical_repository": "https://github.com/p457techspecs333-del/techspecs-data"
}