Fingerprint the structural machine contract of a public OpenAPI or Swagger speci

Fingerprint the structural machine contract of a public OpenAPI or Swagger specification and compare it with an optional previous SHA-256 fingerprint to detect API contract drift. Paths, operations, parameters, security and component schema structure are tracked while documentation-only text and examples are ignored. No API operation is executed. Base mainnet USDC

Paid test badge: not yet. The checks above are free: we call the tool without paying and read the payment request it sends back. The Verified badge needs paid calls whose answers match the promised output, and nobody can buy a badge.

Endpoint

POST https://http--forest-gas-station-mainnet--lcjl27p8lmjs.code.run/openapi/schema-state

Our checks, last 30 days

Example input (from the provider)

{
  "body": {
    "url": "https://http--forest-gas-station-mainnet--lcjl27p8lmjs.code.run/openapi.json"
  },
  "bodyType": "json",
  "method": "POST",
  "type": "http"
}

Promised output schema (from the provider)

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "input": {
      "additionalProperties": false,
      "properties": {
        "body": {
          "additionalProperties": false,
          "properties": {
            "previous_hash": {
              "description": "Earlier result hash used to detect a material change.",
              "pattern": "^[a-fA-F0-9]{64}$",
              "type": [
                "string",
                "null"
              ]
            },
            "url": {
              "description": "Public HTTP(S) URL to inspect, resolve, or compare.",
              "maxLength": 2048,
              "minLength": 1,
              "pattern": "^https?://",
              "type": "string"
            }
          },
          "required": [
            "url"
          ],
          "type": "object"
        },
        "bodyType": {
          "enum": [
            "json",
            "form-data",
            "text"
          ],
          "type": "string"
        },
        "method": {
          "enum": [
            "POST"
          ],
          "type": "string"
        },
        "type": {
          "const": "http",
          "type": "string"
        }
      },
      "required": [
        "type",
        "method",
        "bodyType",
        "body"
      ],
      "type": "object"
    },
    "output": {
      "properties": {
        "example": {
          "additionalProperties": false,
          "properties": {
            "capability": {
              "const": "openapi.schema-state",
              "description": "Public capability value used to scope this lookup."
            },
            "data": {
              "additionalProperties": false,
              "description": "Public data value used to scope this lookup.",
              "properties": {
                "changed": {
                  "description": "Public changed value used to scope this lookup.",
                  "type": [
                    "boolean",
                    "null"
                  ]
                },
                "component_schema_count": {
                  "description": "Public component schema count value used to scope this lookup.",
                  "minimum": 0,
                  "type": "integer"
                },
                "fingerprint_scope": {
                  "description": "Public fingerprint scope value used to scope this lookup.",
                  "enum": [
                    "machine_contract_structure",
                    "simple_yaml_operation_summary",
                    "unavailable"
                  ]
                },
                "new_hash": {
                  "description": "Public new hash value used to scope this lookup.",
                  "pattern": "^[a-fA-F0-9]{64}$",
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "operation_count": {
                  "description": "Public operation count value used to scope this lookup.",
                  "minimum": 0,
                  "type": "integer"
                },
                "parse_valid": {
                  "description": "Public parse valid value used to scope this lookup.",
                  "type": "boolean"
                },
                "previous_hash": {
                  "description": "Earlier result hash used to detect a material change.",
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "scope": {
                  "const": "structural_contract_fingerprint_no_operation_execution",
                  "description": "Public scope value used to scope this lookup."
                },
                "url": {
                  "description": "Public HTTP(S) URL to inspect, resolve, or compare.",
                  "type": "string"
                },
                "version": {
                  "description": "Package version whose public metadata should be checked.",
                  "type": [
                    "string",
                    "null"
                  ]
                }
              },
              "required": [
                "url",
                "parse_valid",
                "version",
                "operation_count",
                "component_schema_count",
                "fingerprint_scope",
                "changed",
                "previous_hash",
                "new_hash",
                "scope"
              ],
              "type": "object"
            },
            "meta": {
              "additionalProperties": false,
              "description": "Public meta value used to scope this lookup.",
              "properties": {
                "cache": {
                  "description": "Public cache value used to scope this lookup.",
                  "enum": [
                    "hit",
                    "miss",
                    "bypass"
                  ]
                },
                "checked_at": {
                  "description": "Public checked at value used to scope this lookup.",
                  "type": "string"
                },
                "duration_ms": {
                  "description": "Public duration ms value used to scope this lookup.",
                  "minimum": 0,
                  "type": "integer"
                },
                "provider": {
                  "description": "Public provider value used to scope this lookup.",
                  "type": [
                    "string",
                    "null"
                  ]
                }
              },
              "required": [
                "provider",
                "checked_at",
                "cache",
                "duration_ms"
              ],
              "type": "object"
            },
            "ok": {
              "const": true,
              "description": "Public ok value used to scope this lookup."
      

This page as JSON