Match IP API

Documentação dos Endpoints
🌐 Site GitHub 📦 npm

API Reference

API pública e gratuita para verificação e análise de IPs. Sem autenticação necessária.

https://matchip.squareweb.app
Endpoints
GET/pingHealth check

Verifica se a API está online.

Resposta
{ "status": "ok", "version": "1.0.0" }
Exemplo
curl https://matchip.squareweb.app/ping
GET/api/check/:ipVerificar IP no AbuseIPDB

Retorna dados completos do IP diretamente do AbuseIPDB.

Exemplo
curl https://matchip.squareweb.app/api/check/8.8.8.8
POST/analyzeIP + Análise de IA (CLI)

Combina AbuseIPDB com análise gerada por Llama 3.1. Usado pela CLI matchip.

Body
{ "ip": "185.220.101.1" }
Exemplo
curl -X POST https://matchip.squareweb.app/analyze \
  -H "Content-Type: application/json" \
  -d '{"ip": "185.220.101.1"}'
CLI — Match IP
📦 Instalação
npm install -g @flowtemperature/matchip
npx @flowtemperature/matchip 8.8.8.8
💻 Uso
matchip 8.8.8.8   # analisa IP
matchip ping      # verifica API
matchip help      # ajuda
Limites & Notas

• API gratuita e pública — sem autenticação.

• Dados fornecidos pelo AbuseIPDB.

• Análise de IA gerada pelo Llama 3.1 8B via Flow API.

• IPs com score ≥ 25 são bloqueados automaticamente.

• Rate limit: 30 requisições / 60 segundos por IP.

• Licença: MIT