{
  "openapi": "3.1.0",
  "info": {
    "title": "IndexAgentic API",
    "version": "2.1.0",
    "description": "Registro Comercial Aberto do Brasil para Agentes de IA"
  },
  "servers": [
    {
      "url": "https://indexagentic.com.br"
    }
  ],
  "paths": {
    "/api/v1/search": {
      "get": {
        "summary": "Busca textual",
        "parameters": [
          {
            "name": "q",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "uf",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "city",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "min_trust_score",
            "in": "query",
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/v1/diagnose": {
      "get": {
        "summary": "Diagnóstico read-only",
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/v1/verify/{identifier}": {
      "get": {
        "summary": "Consulta por CNPJ ou domínio",
        "parameters": [
          {
            "name": "identifier",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/v1/offerings/{domain}": {
      "get": {
        "summary": "Ofertas de um domínio",
        "parameters": [
          {
            "name": "domain",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/v1/stats": {
      "get": {
        "summary": "Métricas públicas",
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/v1/verify-signature/{domain}": {
      "get": {
        "summary": "Verifica a assinatura Ed25519 de um nó",
        "parameters": [
          {
            "name": "domain",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          },
          "404": {
            "description": "Not found"
          }
        }
      }
    },
    "/mcp/rpc": {
      "post": {
        "summary": "JSON-RPC MCP (global)",
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/mcp/{domain}": {
      "post": {
        "summary": "JSON-RPC MCP por domínio",
        "parameters": [
          {
            "name": "domain",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          },
          "404": {
            "description": "domain_not_found"
          },
          "429": {
            "description": "rate_limit_exceeded"
          }
        }
      }
    },
    "/nodes/{domain}/agent-summary.json": {
      "get": {
        "summary": "Agent Decision Card (≤3KB, 1 request, assinado Ed25519)",
        "description": "Inclui entity.schema_org_type (Store/SoftwareApplication/FinancialService/ProfessionalService/LocalBusiness/Organization) e declarations.differentiators_identified.",
        "parameters": [
          {
            "name": "domain",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          },
          "404": {
            "description": "not_found"
          }
        }
      }
    },
    "/nodes/{domain}/trust-context.json": {
      "get": {
        "summary": "Percentis de confiança (global, por profile, por CNAE)",
        "parameters": [
          {
            "name": "domain",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          },
          "404": {
            "description": "not_found"
          },
          "503": {
            "description": "trust_context_unavailable"
          }
        }
      }
    },
    "/.well-known/security.txt": {
      "get": {
        "summary": "Política de disclosure responsável (RFC 9116) — assinada com Ed25519",
        "responses": {
          "200": {
            "description": "text/plain assinado"
          }
        }
      }
    },
    "/.well-known/jwks.json": {
      "get": {
        "summary": "Chaves públicas Ed25519 (multi-key após rotação)",
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/.well-known/did.json": {
      "get": {
        "summary": "DID descentralizado",
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/nodes/{domain}": {
      "get": {
        "summary": "Página mestra SSR",
        "parameters": [
          {
            "name": "domain",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "text/html"
          }
        }
      }
    },
    "/nodes/{domain}/llms.txt": {
      "get": {
        "summary": "Índice llms.txt",
        "parameters": [
          {
            "name": "domain",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "text/markdown"
          }
        }
      }
    },
    "/nodes/{domain}/llms-full.txt": {
      "get": {
        "summary": "Corpus completo",
        "parameters": [
          {
            "name": "domain",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "text/plain"
          }
        }
      }
    },
    "/nodes/{domain}/ai-catalog.json": {
      "get": {
        "summary": "Catálogo executável (Schema.org OfferCatalog)",
        "parameters": [
          {
            "name": "domain",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/nodes/{domain}/trust.json": {
      "get": {
        "summary": "Assertions assinadas (Ed25519)",
        "parameters": [
          {
            "name": "domain",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/nodes/{domain}/trust-chain.json": {
      "get": {
        "summary": "Histórico append-only de mudanças",
        "parameters": [
          {
            "name": "domain",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/nodes/{domain}/merkle-root.json": {
      "get": {
        "summary": "Merkle root do histórico",
        "parameters": [
          {
            "name": "domain",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/nodes/{domain}/receipts.json": {
      "get": {
        "summary": "Índice de recibos assinados",
        "parameters": [
          {
            "name": "domain",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/nodes/{domain}/receipts/cnpj.json": {
      "get": {
        "summary": "Recibo CNPJ ativo na Receita",
        "parameters": [
          {
            "name": "domain",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/nodes/{domain}/receipts/catalog.json": {
      "get": {
        "summary": "Recibo catálogo verificado",
        "parameters": [
          {
            "name": "domain",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/nodes/{domain}/mcp/server-card.json": {
      "get": {
        "summary": "MCP Server Card",
        "parameters": [
          {
            "name": "domain",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/nodes/{domain}/jwks.json": {
      "get": {
        "summary": "JWKS por domínio",
        "parameters": [
          {
            "name": "domain",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/nodes/{domain}/did.json": {
      "get": {
        "summary": "DID por domínio",
        "parameters": [
          {
            "name": "domain",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/nodes/{domain}/receipts/domain.json": {
      "get": {
        "summary": "Recibo RDAP (registrante do domínio bate com razão social)",
        "parameters": [
          {
            "name": "domain",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          },
          "404": {
            "description": "not_generated_yet"
          }
        }
      }
    },
    "/nodes/{domain}/receipts/mcp.json": {
      "get": {
        "summary": "Recibo MCP probe (site expõe MCP compatível)",
        "parameters": [
          {
            "name": "domain",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          },
          "404": {
            "description": "not_generated_yet"
          }
        }
      }
    },
    "/nodes/{domain}/receipts/description.json": {
      "get": {
        "summary": "Recibo descrição aprovada pelo dono",
        "parameters": [
          {
            "name": "domain",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          },
          "404": {
            "description": "not_generated_yet"
          }
        }
      }
    },
    "/admin/receipts/refresh": {
      "post": {
        "summary": "Force refresh dos recibos extras de um domínio (admin)",
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/admin/nodes/{domain}/description": {
      "post": {
        "summary": "Define descrição aprovada pelo dono (admin)",
        "parameters": [
          {
            "name": "domain",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/v1/claim/enrich": {
      "post": {
        "summary": "Enriquece o perfil via claim (Dono envia dados, BrasilAPI puxa CNAE)",
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    }
  }
}