{
  "info": {
    "name": "CNPJ.Platform — API pública v1",
    "description": "Collection oficial dos 3 endpoints públicos. Variáveis: {{base_url}} (default https://api.cnpj-platform.example) e {{api_key}} (criar em /dashboard/api). Documentação: /docs",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json",
    "_postman_id": "cnpj-platform-public-api-v1"
  },
  "variable": [
    {
      "key": "base_url",
      "value": "http://localhost:4000",
      "description": "URL base da API. Em prod: https://api.<seu-dominio>"
    },
    {
      "key": "api_key",
      "value": "cnpj_live_SUACHAVE",
      "description": "Sua chave x-api-key. Criar em /dashboard/api (Pro+ apenas)."
    },
    {
      "key": "exemplo_cnpj",
      "value": "33000167000101",
      "description": "CNPJ Petrobras — usado nos exemplos"
    }
  ],
  "auth": {
    "type": "apikey",
    "apikey": [
      { "key": "key", "value": "x-api-key", "type": "string" },
      { "key": "value", "value": "{{api_key}}", "type": "string" },
      { "key": "in", "value": "header", "type": "string" }
    ]
  },
  "item": [
    {
      "name": "1. Buscar CNPJ por número",
      "request": {
        "method": "GET",
        "header": [
          { "key": "x-api-key", "value": "{{api_key}}", "description": "Chave criada em /dashboard/api" }
        ],
        "url": {
          "raw": "{{base_url}}/v1/public/cnpj/{{exemplo_cnpj}}",
          "host": ["{{base_url}}"],
          "path": ["v1", "public", "cnpj", "{{exemplo_cnpj}}"]
        },
        "description": "Detalhe completo de uma empresa por CNPJ (14 dígitos sem formatação). Retorna empresa + estabelecimento + sócios + Lead Score determinístico (Pro+)."
      },
      "response": []
    },
    {
      "name": "2. Buscar empresas por filtros",
      "request": {
        "method": "GET",
        "header": [
          { "key": "x-api-key", "value": "{{api_key}}" }
        ],
        "url": {
          "raw": "{{base_url}}/v1/public/search?q=banco&uf=SP&porte=05&limit=20",
          "host": ["{{base_url}}"],
          "path": ["v1", "public", "search"],
          "query": [
            { "key": "q", "value": "banco", "description": "Texto livre (FTS+trigram em razao_social)" },
            { "key": "uf", "value": "SP", "description": "UF (csv: SP,RJ)" },
            { "key": "porte", "value": "05", "description": "01=ME, 03=EPP, 05=Demais" },
            { "key": "limit", "value": "20", "description": "Pro: 1-50; Enterprise: 1-200" },
            { "key": "offset", "value": "0", "description": "Paginação", "disabled": true },
            { "key": "cnaePrincipal", "value": "6422100", "description": "CNAE 7-dígitos", "disabled": true },
            { "key": "comEmail", "value": "true", "description": "Apenas empresas com email", "disabled": true },
            { "key": "comTelefone", "value": "true", "description": "Apenas empresas com telefone", "disabled": true },
            { "key": "capitalMin", "value": "1000000", "description": "Capital social mínimo (BRL)", "disabled": true },
            { "key": "aberturaMin", "value": "2020-01-01", "description": "Data abertura mínima (YYYY-MM-DD)", "disabled": true },
            { "key": "apenasMei", "value": "true", "description": "Apenas MEI", "disabled": true },
            { "key": "apenasSimplesNacional", "value": "true", "description": "Apenas Simples Nacional", "disabled": true }
          ]
        },
        "description": "Busca paginada com filtros combinados. Retorna lista resumida + total (estimado quando >10k matches, sinalizado por totalEstimated:true)."
      },
      "response": []
    },
    {
      "name": "3. Stats da base atual",
      "request": {
        "method": "GET",
        "header": [
          { "key": "x-api-key", "value": "{{api_key}}" }
        ],
        "url": {
          "raw": "{{base_url}}/v1/public/stats",
          "host": ["{{base_url}}"],
          "path": ["v1", "public", "stats"]
        },
        "description": "Counts da base atual (empresas, estabelecimentos ativos, sócios) + release atual + timestamp. Cache Redis 1h. Numbers vêm de pg_class.reltuples (estimativa autovacuum, <1% drift)."
      },
      "response": []
    }
  ]
}