10x402.com

{
  "properties": {
    "checks_run": {
      "description": "how many checks APPLIED. A v1-only endpoint legitimately skips every v2 check, so this is the denominator a caller needs before comparing two reports.",
      "type": "integer"
    },
    "findings": {
      "items": {
        "properties": {
          "bucket": {
            "description": "a diagnostic pile this finding belongs to, kept separate from schema drift. `edge-invented` means the response was minted on the path rather than by the origin, which is a vendor CONFIGURATION rather than a vendor bug and wants the opposite fix. Present only on ORIGIN_MARKER_PRESENT today.",
            "enum": [
              "edge-invented"
            ],
            "type": "string"
          },
          "code": {
            "enum": [
              "HTTP_STATUS_402",
              "HTTP_FREE_TIER_200",
              "HTTP_SERVER_ERROR",
              "HTTP_REDIRECT",
              "HTTP_CONTENT_TYPE_JSON",
              "ENVELOPE_PRESENT",
              "HTTP_ROUTE_DISCRIMINATES",
              "HTTP_SOFT_404",
              "UA_GATE_402",
              "UA_GATE_SURFACES",
              "ORIGIN_MARKER_PRESENT",
              "V2_HEADER_PRESENT",
              "V2_B64_URLSAFE",
              "V2_B64_DECODE",
              "V2_JSON",
              "V2_VERSION",
              "V2_ACCEPTS_NONEMPTY",
              "V2_SCHEME",
              "V2_SCHEME_KNOWN",
              "V2_NETWORK_CAIP2",
              "V2_NETWORK_CAIP2_STYLE",
              "V2_NAMESPACE_KNOWN",
              "V2_NETWORK_SUPPORTED",
              "V2_AMOUNT",
              "V2_AMOUNT_ATOMIC",
              "V2_AMOUNT_MINIMUM",
              "V2_INDEX_AMOUNT",
              "V2_INDEX_TIMEOUT",
              "V2_INDEX_ASSET",
              "V2_INDEX_PAYTO",
              "V2_PAYTO",
              "V2_ASSET",
              "V2_MAX_TIMEOUT",
              "V2_EXTRA_EIP712",
              "V2_ACCEPTS_V1_FIELDS",
              "V2_RESOURCE_OBJECT",
              "V2_RESOURCE_URL_PARSES",
              "V2_RESOURCE_URL",
              "V2_RESOURCE_METHOD",
              "V2_RESOURCE_DESCRIPTION",
              "V2_RESOURCE_MIMETYPE",
              "V2_RESOURCE_URL_MATCHES",
              "V2_SERVICE_NAME",
              "V2_TAGS",
              "V2_BAZAAR_PRESENT",
              "V2_BAZAAR_INFO",
              "V2_BAZAAR_SCHEMA",
              "V2_BAZAAR_SCHEMA_CONTENT",
              "V2_BAZAAR_INFO_VALIDATES",
              "V2_BAZAAR_BAG_MISMATCH",
              "V2_BAZAAR_INPUT",
              "V2_BAZAAR_INPUT_TYPE",
              "V2_BAZAAR_INPUT_METHOD",
              "V2_BAZAAR_OUTPUT_TYPE",
              "V2_BAZAAR_OUTPUT_EXAMPLE",
              "V2_BAZAAR_INPUT_REPLAYABLE",
              "V2_BAZAAR_INPUT_QUERY_EXAMPLE",
              "V1_ABSENT",
              "V1_BODY_NOT_ENVELOPE",
              "V1_BODY_PRESENT",
              "V1_BODY_JSON",
              "V1_VERSION",
              "V1_ACCEPTS_NONEMPTY",
              "V1_SCHEME",
              "V1_SCHEME_KNOWN",
              "V1_MAX_AMOUNT_REQUIRED",
              "V1_AMOUNT_ATOMIC",
              "V1_NETWORK_NAME",
              "V1_NETWORK_KNOWN",
              "V1_RESOURCE_STRING",
              "V1_PAYTO",
              "V1_ASSET",
              "V1_MIMETYPE",
              "V1_DESCRIPTION",
              "V1_MAX_TIMEOUT",
              "V1_EXTRA_EIP712",
              "V1_OUTPUT_SCHEMA",
              "V1_DISCOVERABLE",
              "DUAL_PAYTO",
              "DUAL_PRICE",
              "DUAL_NETWORK",
              "DUAL_ASSET",
              "DUAL_RESOURCE",
              "VERSION_HEADER_SAYS_V1",
              "VERSION_BODY_SAYS_V2",
              "BILLING_TERMS_DISCLOSED",
              "EMPTY_BODY_200",
              "UNPARSEABLE_BODY_200",
              "SCHEMA_SHAPE_200",
              "DEGENERATE_TEXT_200",
              "CROSS_ROUTE_CONSISTENCY",
              "LISTED_PRICE_MATCHES",
              "ACCEPTS_TRUNCATED",
              "FINDINGS_TRUNCATED"
            ],
            "type": "string"
          },
          "core": {
            "description": "whether THIS finding makes the envelope unusable as published. Resolved per finding rather than per check: HTTP_STATUS_402 is core on a 401 and not on a 405, where the linter's own choice of verb is as likely an explanation.",
            "type": "boolean"
          },
          "fix": {
            "description": "exactly how to fix it",
            "type": "string"
          },
          "message": {
            "description": "what is wrong, in this envelope",
            "type": "string"
          },
          "severity": {
            "enum": [
              "error",
              "warn",
              "info"
            ],
            "type": "string"
          }
        },
        "required": [
          "severity",
          "code",
          "message",
          "fix"
        ],
        "type": "object"
      },
      "type": "array"
    },
    "grade": {
      "description": "CAN THIS ENDPOINT BE PAID, and only that. Computed from payment-regime findings; discovery is reported separately as summary.bazaar_ready. A: zero payment-regime errors and zero payment-regime warnings; B: zero payment-regime errors, one or two warnings; C: zero payment-regime errors, three or more warnings; D: one or more payment-regime errors, none of them core; F: any core error — the envelope is not usable as published",
      "enum": [
        "A",
        "B",
        "C",
        "D",
        "F"
      ],
      "type": "string"
    },
    "summary": {
      "properties": {
        "bazaar_ready": {
          "description": "CAN THIS ENDPOINT BE FOUND — the second verdict, from bazaar-regime errors. \"n/a\" for a v1-only endpoint, whose CDP requirements are a v2 shape. Grade A with bazaar_ready false is a real and common answer: payable, and not catalogued.",
          "oneOf": [
            {
              "type": "boolean"
            },
            {
              "enum": [
                "n/a"
              ],
              "type": "string"
            }
          ]
        },
        "blockers": {
          "description": "the check codes standing between this resource and an index entry",
          "items": {
            "enum": [
              "V2_HEADER_PRESENT",
              "V2_NETWORK_SUPPORTED",
              "V2_AMOUNT_MINIMUM",
              "V2_INDEX_AMOUNT",
              "V2_INDEX_TIMEOUT",
              "V2_INDEX_ASSET",
              "V2_INDEX_PAYTO",
              "V2_RESOURCE_URL",
              "V2_RESOURCE_METHOD",
              "V2_RESOURCE_DESCRIPTION",
              "V2_SERVICE_NAME",
              "V2_TAGS",
              "V2_BAZAAR_PRESENT",
              "V2_BAZAAR_INFO",
              "V2_BAZAAR_SCHEMA",
              "V2_BAZAAR_SCHEMA_CONTENT",
              "V2_BAZAAR_INFO_VALIDATES",
              "V2_BAZAAR_BAG_MISMATCH",
              "V2_BAZAAR_INPUT",
              "V2_BAZAAR_INPUT_TYPE",
              "V2_BAZAAR_INPUT_METHOD",
              "V2_BAZAAR_OUTPUT_TYPE",
              "V2_BAZAAR_OUTPUT_EXAMPLE",
              "V1_OUTPUT_SCHEMA",
              "V1_DISCOVERABLE"
            ],
            "type": "string"
          },
          "type": "array"
        },
        "edge_invented": {
          "description": "present when the linted response did not carry the origin marker the endpoint advertises, so an intermediary minted it rather than the origin. Every other finding in the report then describes that intermediary's reply, not the seller's envelope. Only set when a marker is advertised — see ORIGIN_MARKER_PRESENT.",
          "type": "string"
        },
        "network": {
          "type": [
            "string",
            "null"
          ]
        },
        "partial": {
          "description": "present when the response was not a 402 and carried no envelope, so the envelope checks could not run",
          "type": "string"
        },
        "payTo": {
          "type": [
            "string",
            "null"
          ]
        },
        "price": {
          "type": [
            "string",
            "null"
          ]
        },
        "versions_detected": {
          "items": {
            "enum": [
              1,
              2
            ],
            "type": "integer"
          },
          "type": "array"
        }
      },
      "type": "object"
    }
  },
  "required": [
    "grade",
    "summary",
    "findings",
    "checks_run"
  ],
  "type": "object"
}