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). |
JSON Schema
{
"$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.
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.