{
  "openapi": "3.1.0",
  "info": {
    "title": "OmniVenture DevOps Edge Sentries & Infrastructure Attestation",
    "version": "1.0.0",
    "description": "Programmatic infrastructure monitoring, cryptographic integrity proofing, and statistical anomaly detection for DevOps bots, uptime sentries, and automated pipelines.\n\n### Included Endpoints:\n1. **SSL & TLS Certificate Health Auditor** (`POST /v1/m2m/audit/ssl`): Audits certificate validity windows, issuer authority, and days remaining.\n2. **Cryptographic SHA-256 Validator** (`POST /v1/m2m/validate`): Attestation digests and structural integrity proofs.\n3. **Statistical Discrepancy & Anomaly Radar** (`POST /v1/m2m/delta-scan`): Calculates numerical divergence between streaming series.\n4. **Real-Time Usage & Telemetry Monitor** (`GET /v1/m2m/monitor/usage`): Real-time call counts, settled revenue, and daily cadence.",
    "contact": {
      "name": "OmniVenture Autonomous Fleet",
      "email": "dalnaspidal@gmail.com"
    },
    "x-category": "Tools"
  },
  "paths": {
    "/v1/m2m/delta-scan": {
      "post": {
        "tags": [
          "M2M Agnostic Micro-Services"
        ],
        "summary": "Statistical Discrepancy & Anomaly Radar",
        "description": "Calculates statistical divergence, volatility deltas, and probability anomalies between parallel streaming series, price feeds, or numerical arrays.\n\n### Use when:\n- Detecting arbitrage spreads between exchanges or disparate market data feeds.\n- Monitoring data pipeline drift or metric outliers across multi-agent sensor arrays.\n- Offloading numerical divergence and percentage delta threshold math from LLM reasoning context.\n\n### Do not use when:\n- Comparing non-numerical strings, text narratives, or unstructured prose.\n\n### Token & Latency Advantage:\n- Replaces hundreds of lines of LLM arithmetic thinking tokens with instant deterministic SIMD floating-point math (<5ms).\n\n### Pricing:\n- \u00a30.05 GBP / call.",
        "operationId": "delta_scan_endpoint_v1_m2m_delta_scan_post",
        "parameters": [
          {
            "name": "authorization",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Authorization"
            }
          },
          {
            "name": "x-payment-token",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Payment-Token"
            }
          },
          {
            "name": "x-rapidapi-key",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Rapidapi-Key"
            }
          },
          {
            "name": "x-rapidapi-proxy-secret",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Rapidapi-Proxy-Secret"
            }
          },
          {
            "name": "x-rapidapi-user",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Rapidapi-User"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/M2MPayloadRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/m2m/validate": {
      "post": {
        "tags": [
          "M2M Agnostic Micro-Services"
        ],
        "summary": "Cryptographic SHA-256 Integrity & Hash Attestation",
        "description": "Generates canonical SHA-256 cryptographic digests, verifies payload structural consistency, and validates data against expected hashes.\n\n### Use when:\n- Attesting data integrity between autonomous agent handoffs and tool executions.\n- Detecting whether an external payload has mutated or suffered bit rot across pipeline stages.\n- Validating state snapshots against canonical cryptographic proofs.\n\n### Do not use when:\n- Transforming or restructuring data content.\n\n### Token & Latency Advantage:\n- 100% deterministic cryptographic hashing with zero model hallucination. Sub-2ms execution.\n\n### Pricing:\n- \u00a30.01 GBP / call.",
        "operationId": "validate_endpoint_v1_m2m_validate_post",
        "parameters": [
          {
            "name": "authorization",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Authorization"
            }
          },
          {
            "name": "x-payment-token",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Payment-Token"
            }
          },
          {
            "name": "x-rapidapi-key",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Rapidapi-Key"
            }
          },
          {
            "name": "x-rapidapi-proxy-secret",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Rapidapi-Proxy-Secret"
            }
          },
          {
            "name": "x-rapidapi-user",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Rapidapi-User"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/M2MPayloadRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/m2m/monitor/usage": {
      "get": {
        "tags": [
          "M2M Agnostic Micro-Services"
        ],
        "summary": "Real-Time Usage & Financial Telemetry",
        "description": "Real-time usage and financial telemetry endpoint.\n\n### Use when:\n- Monitoring 24h and 7d call volumes across all micro-services.\n- Inspecting settled revenue by payment rail (L402 vs RapidAPI PayPal) and caller.\n- Tracking autonomous daily expansion cadence and service health.",
        "operationId": "monitor_usage_endpoint_v1_m2m_monitor_usage_get",
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/m2m/audit/ssl": {
      "post": {
        "tags": [
          "M2M Agnostic Micro-Services"
        ],
        "summary": "SSL & TLS Certificate Health Auditor",
        "description": "Audits SSL/TLS certificate validity windows, days until expiration, certificate authority (issuer), and Subject Alternative Names (SAN) via live TLS handshake.\n\n### Use when:\n- DevOps bots and synthetic uptime sentries monitor domain SSL certificates before expiration.\n- Validating TLS security posture of external API targets before establishing automated data pipelines.\n- Detecting expired, expiring (<14 days), or misconfigured HTTPS certificates.\n\n### Do not use when:\n- Checking non-HTTPS or non-TLS plain TCP endpoints.\n\n### Token & Latency Advantage:\n- Sub-20ms live TLS handshake and certificate chain extraction on edge compute.\n\n### Pricing:\n- \u00a30.01 GBP / call.",
        "operationId": "audit_ssl_endpoint_v1_m2m_audit_ssl_post",
        "parameters": [
          {
            "name": "authorization",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Authorization"
            }
          },
          {
            "name": "x-payment-token",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Payment-Token"
            }
          },
          {
            "name": "x-rapidapi-key",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Rapidapi-Key"
            }
          },
          {
            "name": "x-rapidapi-proxy-secret",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Rapidapi-Proxy-Secret"
            }
          },
          {
            "name": "x-rapidapi-user",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Rapidapi-User"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/M2MPayloadRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "DirectiveRequest": {
        "properties": {
          "message": {
            "type": "string",
            "title": "Message"
          }
        },
        "type": "object",
        "required": [
          "message"
        ],
        "title": "DirectiveRequest"
      },
      "HTTPValidationError": {
        "properties": {
          "detail": {
            "items": {
              "$ref": "#/components/schemas/ValidationError"
            },
            "type": "array",
            "title": "Detail"
          }
        },
        "type": "object",
        "title": "HTTPValidationError"
      },
      "M2MPayloadRequest": {
        "properties": {
          "client_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Client Id",
            "description": "Machine caller identifier or agent loop instance ID for telemetry.",
            "default": "m2m_client"
          },
          "payload": {
            "anyOf": [
              {
                "additionalProperties": true,
                "type": "object"
              },
              {
                "type": "null"
              }
            ],
            "title": "Payload",
            "description": "Arbitrary JSON payload or dictionary to normalize, transform, or cryptographically hash."
          },
          "raw_text": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Raw Text",
            "description": "Raw unstructured text string for entity distillation, keyword extraction, or compression."
          },
          "url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Url",
            "description": "Target web URL (e.g. 'https://example.com/doc') to scrape and compress into clean Markdown."
          },
          "raw_html": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Raw Html",
            "description": "Raw HTML markup string to convert into clean, token-efficient Markdown."
          },
          "html": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Html",
            "description": "Alias for raw_html."
          },
          "include_links": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "title": "Include Links",
            "description": "When converting HTML/URL to Markdown, whether to retain hyperlinks in [text](url) format.",
            "default": false
          },
          "max_tokens": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Max Tokens",
            "description": "Maximum token budget for Markdown extraction or text output.",
            "default": 4000
          },
          "series_a": {
            "anyOf": [
              {},
              {
                "type": "null"
              }
            ],
            "title": "Series A",
            "description": "Primary numerical value or array of floats for discrepancy/anomaly comparison."
          },
          "series_b": {
            "anyOf": [
              {},
              {
                "type": "null"
              }
            ],
            "title": "Series B",
            "description": "Secondary baseline numerical value or array of floats for discrepancy comparison."
          },
          "threshold_pct": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "title": "Threshold Pct",
            "description": "Percentage divergence threshold (e.g. 5.0%) above which a delta is flagged as an anomaly.",
            "default": 5.0
          },
          "expected_hash": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Expected Hash",
            "description": "Optional expected 64-char hexadecimal SHA-256 digest to verify against payload digest."
          },
          "strip_nulls": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "title": "Strip Nulls",
            "description": "When transforming JSON, whether to recursively prune keys with null/empty values.",
            "default": true
          },
          "max_keywords": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Max Keywords",
            "description": "Maximum number of salient keywords to extract in context distillation.",
            "default": 5
          },
          "email": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Email",
            "description": "Target email address to validate for RFC compliance, DNS MX records, and burner domain status."
          },
          "check_mx": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "title": "Check Mx",
            "description": "Whether to perform live DNS MX lookup verification for deliverability scoring.",
            "default": true
          },
          "raw_json": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Raw Json",
            "description": "Malformed or unparsed JSON string emitted by an LLM to repair into RFC 8259 valid JSON."
          },
          "broken_json": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Broken Json",
            "description": "Alias for raw_json: malformed JSON string (with code fences, single quotes, trailing commas)."
          },
          "text": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Text",
            "description": "Input text string for PII redaction and sensitive data masking."
          },
          "host": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Host",
            "description": "Fully qualified domain name or hostname (e.g. 'api.github.com') to audit SSL/TLS certificates."
          },
          "port": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Port",
            "description": "TLS port number (defaults to 443).",
            "default": 443
          },
          "timeout_seconds": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "title": "Timeout Seconds",
            "description": "Network socket connection timeout in seconds.",
            "default": 3.0
          },
          "user_agent": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "User Agent",
            "description": "Raw User-Agent header string to classify into AI bot, crawler, scraper, or browser."
          },
          "mask_character": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Mask Character",
            "description": "Optional character used to mask PII tokens (defaults to placeholder tags like [REDACTED_EMAIL])."
          },
          "base_currency": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Base Currency",
            "description": "Base currency symbol for FX oracle rates (e.g. 'GBP', 'USD', 'BTC')."
          },
          "data": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Data",
            "description": "Data payload or invoice string to encode into SVG QR matrix."
          },
          "ip": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Ip",
            "description": "IPv4 or IPv6 address string to evaluate for routing taxonomy, reverse PTR, and private CIDR."
          }
        },
        "type": "object",
        "title": "M2MPayloadRequest"
      },
      "ValidationError": {
        "properties": {
          "loc": {
            "items": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "integer"
                }
              ]
            },
            "type": "array",
            "title": "Location"
          },
          "msg": {
            "type": "string",
            "title": "Message"
          },
          "type": {
            "type": "string",
            "title": "Error Type"
          },
          "input": {
            "title": "Input"
          },
          "ctx": {
            "type": "object",
            "title": "Context"
          }
        },
        "type": "object",
        "required": [
          "loc",
          "msg",
          "type"
        ],
        "title": "ValidationError"
      }
    }
  },
  "servers": [
    {
      "url": "https://automatically-welcome-dad-extensive.trycloudflare.com",
      "description": "Production Edge Execution Gateway (Sub-15ms Bare-Metal Xeon)"
    },
    {
      "url": "https://omniventure-api.web.app",
      "description": "Permanent Canonical Gateway Authority & Developer Hub"
    }
  ],
  "externalDocs": {
    "description": "OmniVenture Developer Hub & Agent Discovery",
    "url": "https://omniventure-api.web.app"
  }
}