{
    "status": "info",
    "api": "Consulta de Registros de Prospecção por CNPJ - Linktudo",
    "versao": "2.1.0",
    "data_atualizacao": "2026-01-16",
    "descricao": "API otimizada para consulta de eventos de prospecção usando índices MySQL. Retorna dados da tabela central_de_prospeccao___registros_de_eventos.",
    "metodo_esperado": "POST",
    "content_type": "application\/json",
    "formato_corpo": "JSON",
    "estrutura_tabela": "central_de_prospeccao___registros_de_eventos",
    "indices_disponiveis": [
        "idx_cnpj",
        "idx_usuario",
        "idx_usuario_status",
        "idx_usuario_tipo",
        "idx_status",
        "idx_tipo_evento",
        "idx_data_registro",
        "idx_data_agendamento",
        "idx_cpf",
        "idx_data_prazo_entrega"
    ],
    "autenticacao": {
        "obrigatorio": "id_do_usuario (recomendado) OU ip",
        "observacao": "Usar id_do_usuario para melhor performance e segurança"
    },
    "parametros_obrigatorios": {
        "cnpj": {
            "tipo": "string",
            "formato": "14 dígitos (apenas números)",
            "exemplo": "17875154000120",
            "observacao": "Remove automaticamente caracteres não numéricos"
        }
    },
    "parametros_opcionais_principais": {
        "id_do_usuario": {
            "tipo": "integer",
            "descricao": "ID do usuário Linktudo",
            "exemplo": 1
        },
        "status": {
            "tipo": "string",
            "descricao": "Status da prospecção",
            "exemplo": "Aberto"
        },
        "tipo_evento": {
            "tipo": "string",
            "descricao": "Tipo do evento",
            "exemplo": "Reunião"
        },
        "ordenar_por": {
            "tipo": "string",
            "valores": [
                "mais_recente",
                "agendamento",
                "valor_desc",
                "mais_antigo"
            ],
            "padrao": "mais_recente"
        }
    },
    "parametros_opcionais_avancados": {
        "pagina": {
            "tipo": "integer",
            "padrao": 1,
            "min": 1
        },
        "itens_por_pagina": {
            "tipo": "integer",
            "padrao": 50,
            "min": 1,
            "max": 100
        },
        "limite": {
            "tipo": "integer",
            "padrao": 150,
            "min": 1,
            "max": 500
        },
        "excluir_datas_zero": {
            "tipo": "boolean",
            "padrao": true
        },
        "campos": {
            "tipo": "string",
            "descricao": "Campos específicos separados por vírgula"
        }
    },
    "exemplos_requisicao": {
        "basico": {
            "cnpj": "17875154000120",
            "id_do_usuario": 1
        },
        "com_filtros": {
            "cnpj": "17875154000120",
            "id_do_usuario": 1,
            "status": "Aberto",
            "tipo_evento": "Reunião",
            "pagina": 1,
            "itens_por_pagina": 20,
            "ordenar_por": "mais_recente"
        }
    },
    "resposta_exemplo": {
        "status": "success",
        "performance": {
            "tempo_execucao_ms": 1.229999999999999982236431605997495353221893310546875,
            "total_registros": 15
        },
        "paginacao": {
            "total_paginas": 2,
            "pagina_atual": 1,
            "has_next": true
        },
        "filtros_aplicados": {
            "status": "Aberto",
            "ordenar_por": "mais_recente"
        },
        "registros": [
            "array de objetos com dados da prospecção"
        ],
        "estatisticas": [
            "totais por status, tipo, valores, etc."
        ]
    },
    "observacoes_tecnicas": [
        "Performance otimizada com índices MySQL",
        "Tratamento automático de datas inválidas (0000-00-00)",
        "Formatação de valores monetários (R$ 1.234,56)",
        "Conversão automática de datas para ISO 8601",
        "Medição de tempo de execução incluída",
        "Estatísticas automáticas dos dados retornados"
    ],
    "codigos_resposta": {
        "200": "Sucesso (dados ou documentação)",
        "400": "Parâmetros inválidos (CNPJ errado, autenticação faltando)",
        "405": "Método HTTP incorreto (use POST)",
        "500": "Erro interno do servidor"
    }
}