Guarita · Schema

Report

O relatório completo de uma ronda — o mesmo documento que o painel mostra e o PDF imprime. Formato do scanner, versionado por `schemaVersion`: `camelCase` na estrutura e `snake_case` dentro de `ai`.

Company

Properties

Name Type Description
schemaVersion string Versão do formato do relatório.
scan object Metadados da execução.
findings array Os achados, do mais grave pro menos grave.
ai object Análise da IA. Numa ronda básica (`ai: false`), bloqueada ou parcial, vem com o `risk_score` calculado e os demais blocos vazios.
infra object Inventário de infraestrutura observado (provedores, ativos, credenciais).
strengths array O que o app já acerta — boas práticas comprovadas na ronda.
lgpd object Pré-diagnóstico LGPD. Só quando a ronda incluiu os módulos LGPD (`lgpd: true` em `POST /scans`, ou a opção da tela).
View JSON Schema on GitHub

JSON Schema

guarita-dev-report-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/guarita-dev/json-schema/guarita-dev-report-schema.json",
  "title": "Report",
  "description": "O relatório completo de uma ronda — o mesmo documento que o painel mostra e o PDF imprime. Formato do scanner, versionado por `schemaVersion`: `camelCase` na estrutura e `snake_case` dentro de `ai`.",
  "x-generated": "2026-11-11",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/guarita-dev-openapi.json#/components/schemas/Report",
  "type": "object",
  "properties": {
    "schemaVersion": {
      "type": "string",
      "enum": [
        "1.0"
      ],
      "description": "Versão do formato do relatório."
    },
    "scan": {
      "$ref": "#/$defs/ReportScan",
      "description": "Metadados da execução."
    },
    "findings": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/Finding"
      },
      "description": "Os achados, do mais grave pro menos grave."
    },
    "ai": {
      "$ref": "#/$defs/AiAssessment",
      "description": "Análise da IA. Numa ronda básica (`ai: false`), bloqueada ou parcial, vem com o `risk_score` calculado e os demais blocos vazios."
    },
    "infra": {
      "$ref": "#/$defs/InfraInventory",
      "description": "Inventário de infraestrutura observado (provedores, ativos, credenciais)."
    },
    "strengths": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "O que o app já acerta — boas práticas comprovadas na ronda."
    },
    "lgpd": {
      "$ref": "#/$defs/LgpdReadiness",
      "description": "Pré-diagnóstico LGPD. Só quando a ronda incluiu os módulos LGPD (`lgpd: true` em `POST /scans`, ou a opção da tela)."
    }
  },
  "required": [
    "schemaVersion",
    "scan",
    "findings",
    "ai",
    "infra"
  ],
  "$defs": {
    "AiAssessment": {
      "type": "object",
      "properties": {
        "executive_summary": {
          "type": "string",
          "description": "Resumo executivo em português."
        },
        "risk_score": {
          "$ref": "#/$defs/RiskScore",
          "description": "Exposição consolidada (0–100 + faixa)."
        },
        "remediation_plan": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/RemediationItem"
          },
          "description": "Plano de correção priorizado."
        },
        "infra_inventory": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/InfraInventoryEntry"
          },
          "description": "Inventário de infra na leitura da IA."
        },
        "finding_verifications": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/FindingVerification"
          },
          "description": "Achados que a IA verificou ativamente, com veredito."
        },
        "risk_scenarios": {
          "type": "array",
          "items": {
            "type": "object",
            "additionalProperties": true
          },
          "description": "Cenários de ataque (formato livre)."
        },
        "owasp_mapping": {
          "type": "array",
          "items": {
            "type": "object",
            "additionalProperties": true
          },
          "description": "Mapeamento OWASP (formato livre)."
        },
        "additional_insights": {
          "type": "array",
          "items": {
            "type": "object",
            "additionalProperties": true
          },
          "description": "Observações extras (formato livre)."
        },
        "cross_infra_chains": {
          "type": "array",
          "items": {
            "type": "object",
            "additionalProperties": true
          },
          "description": "Cadeias entre provedores (formato livre)."
        },
        "discovered_vulnerabilities": {
          "type": "array",
          "items": {
            "type": "object",
            "additionalProperties": true
          },
          "description": "Vulnerabilidades descobertas pela IA (formato livre)."
        }
      },
      "description": "Análise da IA sobre a ronda. Os blocos abaixo têm formato livre (são a saída do modelo) — leia `risk_score` e `remediation_plan`, que são estáveis.",
      "required": [
        "executive_summary",
        "risk_score",
        "remediation_plan",
        "infra_inventory",
        "risk_scenarios",
        "owasp_mapping",
        "additional_insights",
        "cross_infra_chains",
        "discovered_vulnerabilities"
      ]
    },
    "Finding": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "description": "Id do achado DENTRO desta ronda. Renumera entre rondas — pra casar achados entre rondas use `module` + `title`."
        },
        "module": {
          "type": "string",
          "description": "Verificação que produziu o achado (`secrets`, `cors`, `headers`, `supabase`…)."
        },
        "title": {
          "type": "string",
          "description": "Título técnico. Estável entre rondas (é a chave de identidade do achado)."
        },
        "severity": {
          "type": "string",
          "enum": [
            "critical",
            "high",
            "medium",
            "low",
            "info"
          ],
          "description": "Gravidade."
        },
        "cvss": {
          "type": "number",
          "minimum": 0,
          "maximum": 10,
          "description": "Pontuação CVSS."
        },
        "description": {
          "type": "string",
          "description": "O que foi encontrado, em detalhe."
        },
        "evidence": {
          "type": "string",
          "description": "A prova observada: requisição, resposta, trecho do bundle. Valores sensíveis vêm encurtados com `…` — a ronda não guarda o segredo inteiro."
        },
        "recommendation": {
          "type": "string",
          "description": "Recomendação curta do scanner (não é o conserto pronto)."
        },
        "confidence": {
          "type": "string",
          "enum": [
            "confirmed",
            "firm",
            "tentative"
          ],
          "description": "`confirmed` = provado por observação ativa · `firm` = detecção determinística · `tentative` = heurística que pede confirmação. Ausente = `firm`."
        },
        "good": {
          "type": "boolean",
          "description": "Achado POSITIVO: uma boa prática comprovada, não um problema."
        },
        "links": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "Ids de achados relacionados — hoje, os elos de uma cadeia de ataque (`module: \"chain\"`)."
        },
        "friendly": {
          "$ref": "#/$defs/FindingFriendly",
          "description": "A versão em português de gente."
        },
        "fix": {
          "$ref": "#/$defs/FindingFix",
          "description": "O conserto pronto. Ausente quando retido pelo plano — aí vem `fixWithheld: true`."
        },
        "fixWithheld": {
          "type": "boolean",
          "description": "O conserto existe, mas não está nesta resposta (plano sem análise com IA). Diz \"foi retido\", pra não parecer que a ronda não analisou."
        },
        "fixSample": {
          "type": "boolean",
          "description": "Este é o achado-AMOSTRA da conta: o conserto veio inteiro mesmo sem plano. Uma por conta, não por ronda."
        },
        "fixFromCatalog": {
          "type": "boolean",
          "description": "O conserto veio do catálogo determinístico, não da IA (ronda básica)."
        }
      },
      "description": "Um achado da ronda, com a camada leiga e o conserto (quando o plano destrava).",
      "required": [
        "id",
        "module",
        "title",
        "severity",
        "cvss",
        "description",
        "evidence",
        "recommendation"
      ]
    },
    "FindingFix": {
      "type": "object",
      "properties": {
        "prompt": {
          "type": "string",
          "description": "Texto autossuficiente: problema + onde + o que fazer + como validar. É o que se copia e cola no chat da ferramenta."
        },
        "kind": {
          "type": "string",
          "enum": [
            "code",
            "dns",
            "infra",
            "action",
            "confirm",
            "chain"
          ],
          "description": "Tipo de ação: `code` (cola numa IA de código) · `dns` (registro no painel de DNS) · `infra` (console do provedor) · `action` (ação manual) · `confirm` (como confirmar um achado `tentative` antes de mexer) · `chain` (feche qualquer elo da cadeia)."
        },
        "code": {
          "type": "string",
          "description": "Exemplo DIDÁTICO de como a correção costuma ficar. Não é o conserto do seu projeto — quem adapta é a IA, a partir do `prompt`."
        },
        "targets": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "Ferramentas pras quais o prompt foi escrito (`lovable`, `cursor`, `v0`, `bolt`…)."
        }
      },
      "description": "O conserto pronto pra colar numa IA de código (ou o passo manual, conforme `kind`).",
      "required": [
        "prompt"
      ]
    },
    "FindingFriendly": {
      "type": "object",
      "properties": {
        "headline": {
          "type": "string",
          "description": "Título pra pessoa (sem jargão)."
        },
        "whatItIs": {
          "type": "string",
          "description": "O que é."
        },
        "whyItMatters": {
          "type": "string",
          "description": "Por que importa."
        },
        "urgency": {
          "type": "string",
          "enum": [
            "now",
            "soon",
            "later"
          ],
          "description": "Urgência: agora · em breve · quando der."
        }
      },
      "description": "O achado em linguagem de produto.",
      "required": [
        "headline",
        "whatItIs",
        "whyItMatters",
        "urgency"
      ]
    },
    "FindingVerification": {
      "type": "object",
      "properties": {
        "ref_id": {
          "type": "string",
          "description": "Id do achado verificado."
        },
        "verdict": {
          "type": "string",
          "enum": [
            "confirmed",
            "refuted"
          ],
          "description": "`confirmed` = exploração observada · `refuted` = testado e não se sustenta (alarme falso)."
        },
        "evidence": {
          "type": "string",
          "description": "A prova observada."
        }
      },
      "description": "Veredito da IA sobre um achado que ela testou ativamente.",
      "required": [
        "ref_id",
        "verdict",
        "evidence"
      ]
    },
    "InfraAsset": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "description": "Id do ativo dentro da ronda."
        },
        "provider": {
          "type": "string",
          "description": "Provedor."
        },
        "kind": {
          "type": "string",
          "enum": [
            "baas_project",
            "object_storage",
            "serverless_fn",
            "auth",
            "database",
            "api",
            "cdn_host"
          ],
          "description": "Tipo."
        },
        "endpoint": {
          "type": "string",
          "description": "Endereço do ativo."
        },
        "identifier": {
          "type": "string",
          "description": "Identificador no provedor (id do projeto, nome do bucket)."
        },
        "credentials": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/InfraCredential"
          },
          "description": "Credenciais ligadas a este ativo."
        },
        "evidence": {
          "type": "string",
          "description": "Onde foi observado."
        },
        "relatedTo": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "Ids de ativos relacionados."
        }
      },
      "description": "Um ativo de infraestrutura (projeto BaaS, bucket, função, banco…).",
      "required": [
        "id",
        "provider",
        "kind",
        "endpoint",
        "credentials",
        "evidence",
        "relatedTo"
      ]
    },
    "InfraCredential": {
      "type": "object",
      "properties": {
        "kind": {
          "type": "string",
          "enum": [
            "anon_key",
            "service_role",
            "publishable",
            "api_key",
            "access_key",
            "jwt",
            "connection_string",
            "presigned_url"
          ],
          "description": "Tipo da credencial."
        },
        "provider": {
          "type": "string",
          "description": "Provedor."
        },
        "value": {
          "type": "string",
          "description": "Valor observado — encurtado quando sensível."
        },
        "source": {
          "type": "string",
          "description": "Onde foi encontrada."
        },
        "sensitive": {
          "type": "boolean",
          "description": "É segredo (não deveria estar público)."
        }
      },
      "description": "Uma credencial observada.",
      "required": [
        "kind",
        "provider",
        "value",
        "source",
        "sensitive"
      ]
    },
    "InfraInventory": {
      "type": "object",
      "properties": {
        "assets": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/InfraAsset"
          },
          "description": "Ativos descobertos."
        },
        "credentials": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/InfraCredential"
          },
          "description": "Credenciais encontradas (valores sensíveis encurtados)."
        },
        "providers": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "Provedores detectados."
        },
        "scopeHosts": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "Hosts que entraram no escopo da ronda."
        },
        "notes": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "Observações."
        }
      },
      "description": "Inventário de infraestrutura observado pelo scanner.",
      "required": [
        "assets",
        "credentials",
        "providers",
        "scopeHosts",
        "notes"
      ]
    },
    "InfraInventoryEntry": {
      "type": "object",
      "properties": {
        "provider": {
          "type": "string",
          "description": "Provedor (`supabase`, `aws`, `vercel`…)."
        },
        "asset": {
          "type": "string",
          "description": "O ativo (host, bucket, função)."
        },
        "kind": {
          "type": "string",
          "description": "Tipo do ativo."
        },
        "exposure": {
          "type": "string",
          "enum": [
            "public",
            "authenticated",
            "credential_leaked",
            "internal"
          ],
          "description": "Como ele está exposto."
        },
        "notes": {
          "type": "string",
          "description": "Observações."
        }
      },
      "description": "Um ativo de infra na leitura da IA.",
      "required": [
        "provider",
        "asset",
        "kind",
        "exposure",
        "notes"
      ]
    },
    "LgpdReadiness": {
      "type": "object",
      "properties": {
        "score": {
          "type": "integer",
          "minimum": 0,
          "maximum": 100,
          "description": "Prontidão indicativa (maior = menos indícios de não-conformidade)."
        },
        "label": {
          "type": "string",
          "description": "Faixa da prontidão."
        },
        "categories": {
          "type": "array",
          "items": {
            "type": "object",
            "additionalProperties": true
          },
          "description": "Pontuação por categoria (transparência, consentimento, segurança…)."
        },
        "findingCount": {
          "type": "integer",
          "description": "Quantos achados têm relação com a LGPD."
        },
        "disclaimer": {
          "type": "string",
          "description": "O aviso obrigatório: pré-diagnóstico automatizado, não substitui revisão por encarregado/advogado."
        }
      },
      "description": "Pré-diagnóstico técnico de indicadores LGPD. NÃO é parecer jurídico nem atesta conformidade.",
      "required": [
        "score",
        "label",
        "categories",
        "findingCount",
        "disclaimer"
      ]
    },
    "RemediationItem": {
      "type": "object",
      "properties": {
        "priority": {
          "type": "integer",
          "minimum": 1,
          "description": "Ordem (1 = primeiro)."
        },
        "finding_ids": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "Achados que este passo fecha."
        },
        "action": {
          "type": "string",
          "description": "O que fazer."
        },
        "effort": {
          "type": "string",
          "enum": [
            "quick_win",
            "moderate",
            "significant",
            "major_refactor"
          ],
          "description": "Esforço estimado."
        },
        "impact_if_not_fixed": {
          "type": "string",
          "description": "O que acontece se não fizer."
        },
        "scoreImpact": {
          "type": "integer",
          "description": "Quantos pontos de exposição este passo derruba."
        }
      },
      "description": "Um passo do plano de correção.",
      "required": [
        "priority",
        "finding_ids",
        "action",
        "effort",
        "impact_if_not_fixed"
      ]
    },
    "ReportScan": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "description": "Id da ronda."
        },
        "target": {
          "type": "string",
          "format": "uri",
          "description": "URL escaneada."
        },
        "hostname": {
          "type": "string",
          "format": "hostname",
          "description": "Alvo normalizado."
        },
        "stack": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "Stack detectada (ex.: `[\"Lovable\", \"Supabase\", \"Vercel\"]`)."
        },
        "status": {
          "type": "string",
          "enum": [
            "queued",
            "running",
            "analyzing",
            "done",
            "failed",
            "canceled"
          ],
          "description": "Estado."
        },
        "startedAt": {
          "type": "string",
          "format": "date-time",
          "description": "Início da execução."
        },
        "finishedAt": {
          "type": "string",
          "format": "date-time",
          "description": "Fim da execução."
        },
        "durationMs": {
          "type": "integer",
          "description": "Duração em milissegundos."
        },
        "modulesRun": {
          "type": "integer",
          "description": "Quantas verificações rodaram (descontando as puladas)."
        },
        "passive": {
          "type": "boolean",
          "description": "Ronda PASSIVA: só os checks observacionais, porque o domínio não estava verificado (ou excedia a cota de apps verificados do plano)."
        },
        "blocked": {
          "type": "boolean",
          "description": "A ronda não conseguiu ver o app. A IA é pulada e a cota NÃO é consumida."
        },
        "blockedReason": {
          "type": "string",
          "enum": [
            "connection",
            "challenge"
          ],
          "description": "Motivo do bloqueio (só com `blocked`): `connection` ou `challenge`."
        },
        "incomplete": {
          "type": "boolean",
          "description": "O tempo esgotou e a ronda terminou PARCIAL (alguns módulos não rodaram). A IA é pulada e a cota não é consumida."
        }
      },
      "description": "Metadados da execução da ronda.",
      "required": [
        "id",
        "target",
        "hostname",
        "status",
        "durationMs",
        "modulesRun"
      ]
    },
    "RiskScore": {
      "type": "object",
      "properties": {
        "score": {
          "type": "integer",
          "minimum": 0,
          "maximum": 100,
          "description": "0 = tranquilo · 100 = muito exposto. Faixas: seguro (0–14) · baixo (15–39) · médio (40–69) · alto (70–100)."
        },
        "label": {
          "type": "string",
          "enum": [
            "SECURE",
            "LOW_RISK",
            "MODERATE_RISK",
            "HIGH_RISK",
            "CRITICAL_RISK"
          ],
          "description": "Faixa do score."
        },
        "justification": {
          "type": "string",
          "description": "Por que esse número."
        }
      },
      "description": "Exposição consolidada da ronda.",
      "required": [
        "score",
        "label",
        "justification"
      ]
    }
  }
}

Work with this as data

Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for schemas

4 MCP tools reach this
  • find_json_schemasBrowse and filter every JSON Schema in the catalog.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/guarita-dev-report"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.