{
    "api": "API Única Flexível de Prospecção",
    "descricao": "Verifica se CNPJ(s) possuem eventos de prospecção para um usuário específico e retorna a data do evento mais recente",
    "versao": "1.1.0",
    "autor": "Linktudo",
    "timestamp": "2026-10-22T19:27:53-03:00",
    "endpoints": {
        "principal": "\/apis.desabilitado\/linktudo.com.br\/busca\/cnpj\/dados_de_prospeccao\/dados_de_prospeccao___endpoint_api.php",
        "metodos_aceitos": [
            "GET",
            "POST",
            "OPTIONS"
        ]
    },
    "modos_suportados": {
        "single": {
            "descricao": "Consulta um único CNPJ",
            "parametros_obrigatorios": [
                "cnpj",
                "id_do_usuario"
            ],
            "exemplo_requisicao": {
                "metodo": "POST",
                "body": {
                    "cnpj": "17875154000120",
                    "id_do_usuario": 1
                }
            },
            "exemplo_resposta": {
                "status": "success",
                "modo": "single",
                "id_usuario": 1,
                "cnpj": "17875154000120",
                "existe": true,
                "total": 5,
                "ultima_atualizacao": "2026-01-15T14:30:00-03:00",
                "evento_mais_recente": "2026-01-15T14:30:00-03:00",
                "timestamp": "2026-01-17T10:00:00-03:00",
                "performance": {
                    "tempo_execucao_ms": 45.22999999999999687361196265555918216705322265625,
                    "cnpjs_processados": 1,
                    "cnpjs_com_eventos": 1,
                    "cnpjs_sem_eventos": 0
                }
            }
        },
        "batch": {
            "descricao": "Consulta múltiplos CNPJs (até 100 por requisição)",
            "parametros_obrigatorios": [
                "cnpjs",
                "id_do_usuario"
            ],
            "exemplo_requisicao": {
                "metodo": "POST",
                "body": {
                    "cnpjs": [
                        "17875154000120",
                        "98765432000187",
                        "12345678000195"
                    ],
                    "id_do_usuario": 1
                }
            },
            "exemplo_resposta": {
                "status": "success",
                "modo": "batch",
                "id_usuario": 1,
                "timestamp": "2026-01-17T10:00:00-03:00",
                "resultados": {
                    "17875154000120": {
                        "existe": true,
                        "total": 5,
                        "ultima_atualizacao": "2026-01-15T14:30:00-03:00",
                        "evento_mais_recente": "2026-01-15T14:30:00-03:00"
                    },
                    "98765432000187": {
                        "existe": false,
                        "total": 0,
                        "ultima_atualizacao": null,
                        "evento_mais_recente": null
                    },
                    "12345678000195": {
                        "existe": true,
                        "total": 2,
                        "ultima_atualizacao": "2026-01-10T09:15:00-03:00",
                        "evento_mais_recente": "2026-01-10T09:15:00-03:00"
                    }
                },
                "performance": {
                    "tempo_execucao_ms": 120.4500000000000028421709430404007434844970703125,
                    "cnpjs_processados": 3,
                    "cnpjs_com_eventos": 2,
                    "cnpjs_sem_eventos": 1
                }
            }
        }
    },
    "campos_resposta": {
        "comuns": {
            "status": "success ou error",
            "modo": "single ou batch",
            "id_usuario": "ID do usuário consultado",
            "timestamp": "Data\/hora da resposta (ISO 8601)",
            "performance": "Métricas de performance da consulta"
        },
        "single_mode": {
            "cnpj": "CNPJ consultado",
            "existe": "true se existem eventos, false caso contrário",
            "total": "Quantidade total de eventos",
            "ultima_atualizacao": "Data\/hora do último registro (ISO 8601)",
            "evento_mais_recente": "Data\/hora do evento mais recente (baseado em data_hora_registro)"
        },
        "batch_mode": {
            "resultados": "Objeto com resultados para cada CNPJ"
        }
    },
    "erros_comuns": {
        "400": {
            "id_usuario_ausente": "ID do usuário é obrigatório",
            "cnpj_invalido": "CNPJ(s) inválido(s) fornecido(s)",
            "limite_excedido": "Limite de 100 CNPJs por requisição excedido"
        },
        "500": "Erro interno do servidor"
    },
    "formatos": {
        "cnpj": "14 dígitos (com ou sem formatação)",
        "datas": "ISO 8601 (ex: 2026-01-17T10:00:00-03:00)",
        "codificacao": "UTF-8"
    },
    "teste_rapido": {
        "curl_single": "curl -X POST 'https:\/\/linktudo.com.br\/apis.desabilitado\/linktudo.com.br\/busca\/cnpj\/dados_de_prospeccao\/dados_de_prospeccao___endpoint_api.php' -H 'Content-Type: application\/json' -d '{\"cnpj\": \"17875154000120\", \"id_do_usuario\": 1}'",
        "curl_batch": "curl -X POST 'https:\/\/linktudo.com.br\/apis.desabilitado\/linktudo.com.br\/busca\/cnpj\/dados_de_prospeccao\/dados_de_prospeccao___endpoint_api.php' -H 'Content-Type: application\/json' -d '{\"cnpjs\": [\"17875154000120\", \"98765432000187\"], \"id_do_usuario\": 1}'"
    },
    "nota_tecnica": "O campo \"evento_mais_recente\" usa a coluna \"data_hora_registro\" da tabela como referência para a data mais recente do evento."
}