Pontuação de fraude e risco do IPQS
O IPQualityScore (IPQS) fornece prevenção contra fraudes de nível empresarial, análise de risco e detecção de ameaças. Analise endereços IP, números de telefone, endereços de email e URLs ou domínios para identificar maus atores sofisticados e comportamento de alto risco.
Esse conector está disponível nos seguintes produtos e regiões:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Todas as regiões do Power Automate , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Aplicativos Lógicos | Standard | Todas as regiões dos Aplicativos Lógicos , exceto as seguintes: – Regiões do Azure Governamental - Regiões do Azure China - Departamento de Defesa dos EUA (DoD) |
| Power Apps | Premium | Todas as regiões do Power Apps , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Power Automate | Premium | Todas as regiões do Power Automate , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Contato | |
|---|---|
| Nome | Suporte ao IPQS |
| URL | https://www.ipqualityscore.com/contact-us |
| Support@IPQualityScore.com |
| Metadados do conector | |
|---|---|
| Publicador | IPQualityScore |
| Site | https://www.ipqualityscore.com/ |
| Política de privacidade | https://www.ipqualityscore.com/privacy-policy |
| Categorias | Segurança; Site |
O IPQualityScore (IPQS) fornece prevenção contra fraudes de nível empresarial, análise de risco e detecção de ameaças. Analise endereços IP, números de telefone, endereços de email e URLs ou domínios para identificar maus atores sofisticados e comportamento de alto risco em todo o mundo.
Pré-requisitos
Você precisará do seguinte para continuar:
- Um plano do Microsoft Power Apps ou do Power Automate com o recurso de conector personalizado
- Uma assinatura do Azure
- Uma chave de API IPQualityScore
Operações com suporte
O conector dá suporte às seguintes operações:
Retrieve IP address reputation data: esse serviço executa pesquisas em tempo real para determinar instantaneamente o quão arriscado um usuário, clique ou transação é baseado em um endereço IP e informações opcionais do dispositivo. Além de analisar se o endereço IP é um proxy ou VPN, a API retorna mais de 20 pontos de dados relevantes, como:- Dados de localização geográfica
- ISP
- Tipo de conexão
- Detalhes do dispositivo
- Atividade de reputação recente
- Pontuação geral de fraude
- Status como uma conexão proxy, VPN ou TOR
- Velocidade de abuso
- Outros pontos de dados semelhantes para classificar a reputação e o risco
Retrieve Email address reputation data: essa API fornece pontuação e validação de reputação de endereço de email em tempo real com centenas de verificações de sintaxe &DNS. A API pode ser aproveitada para determinar se a caixa de entrada do endereço de email existe com o provedor de serviços de email e é capaz de aceitar novas mensagens. Além disso, os usuários podem determinar se o endereço de email tem uma reputação ruim ou se foi recentemente associado a abusos ou ameaças. A pontuação de risco adicional pode detectar serviços de email descartáveis e temporários, bem como emails com um histórico de comportamento fraudulento online.Retrieve URL (or) Domain reputation data.: verifica links e domínios em tempo real para detectar URLs suspeitas usando modelos confiáveis de machine learning. Esses modelos de machine learning podem identificar com precisão links de phishing, URLs de malware, vírus, domínios estacionados e URLs suspeitas com pontuações de risco em tempo real. Além disso, os modelos de machine learning podem classificar com confiança domínios de má reputação, links suspeitos e URLs de phishing com uma integração de API em tempo real. Recursos como detecção de domínio de estacionamento, pontuações de spam de domínio, verificações de reputação e idade do domínio, eleva a inteligência de URL a um nível totalmente novo.Retrieve Phone Number reputation data: verifique com precisão os números de telefone em todo o mundo e recupere uma combinação de detalhes de tipo de linha e de operadora com dados de análise de risco para avaliar a reputação do número de telefone. O IPQS coleta dados de validação e verificação de telefone de uma ampla variedade de operadoras e provedores de telecomunicações de nível 1, com suporte para todas as regiões. Detecte números de telefone inativos e desconectados para facilitar a validação do usuário semelhante às pesquisas HLR &LRN. Identifique com precisão números de telefone virtuais e descartáveis, juntamente com números associados a comportamentos abusivos online.
Acessar sua chave de API
Registre-se para obter uma chave de API gratuita em IPQualityScore.com ou entre em contato com seu gerente de conta para acessar sua chave de API existente.
Suporte e documentação:
Para todas as solicitações de suporte e consultas gerais, você pode entrar em contato Support@IPQualityScore.com ou entrar em contato conosco
Criando uma conexão
O conector dá suporte aos seguintes tipos de autenticação:
| Default | Parâmetros para criar conexão. | Todas as regiões | Não compartilhável |
Padrão
Aplicável: todas as regiões
Parâmetros para criar conexão.
Essa não é uma conexão compartilhável. Se o aplicativo de energia for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.
| Nome | Tipo | Description | Obrigatório |
|---|---|---|---|
| Chave de API IPQualityScore | secureString | A chave de API IPQualityScore para esta api | Verdade |
Limitações
| Nome | Chamadas | Período de renovação |
|---|---|---|
| Chamadas à API por conexão | 100 | 60 segundos |
Ações
| Recuperar dados de reputação de domínio (ou URL) |
Verifica links e domínios em tempo real para detectar URLs suspeitas usando modelos confiáveis de machine learning. Esses modelos de machine learning podem identificar com precisão links de phishing, URLs de malware, vírus, domínios estacionados e URLs suspeitas com pontuações de risco em tempo real. Além disso, os modelos de machine learning podem classificar com confiança domínios de má reputação, links suspeitos e URLs de phishing com uma integração de API em tempo real. Recursos como detecção de domínio de estacionamento, pontuações de spam de domínio, verificações de reputação e idade do domínio, eleva a inteligência de URL a um nível totalmente novo. |
| Recuperar dados de reputação de endereço de email |
Essa API fornece pontuação e validação de reputação de endereço de email em tempo real com centenas de verificações de sintaxe &DNS. A API pode ser aproveitada para determinar se a caixa de entrada do endereço de email existe com o provedor de serviços de email e é capaz de aceitar novas mensagens. Além disso, os usuários podem determinar se o endereço de email tem uma reputação ruim ou se foi recentemente associado a abusos ou ameaças. A pontuação de risco adicional pode detectar serviços de email descartáveis e temporários, bem como emails com um histórico de comportamento fraudulento online. |
| Recuperar dados de reputação de endereço IP |
Esse serviço executa pesquisas em tempo real para determinar instantaneamente o quão arriscado um usuário, clique ou transação é baseado em um endereço IP e informações opcionais do dispositivo. Além de analisar se o endereço IP é um proxy ou VPN, a API retorna mais de 20 pontos de dados relevantes, como dados de localização geográfica, ISP, tipo de conexão, detalhes do dispositivo, atividade de reputação recente, pontuação geral de fraude, Status como proxy, VPN ou conexão TOR, Velocidade de Abuso, Outros pontos de dados semelhantes para classificar a reputação e o risco. |
| Recuperar dados de reputação do Número de Telefone |
Verifique com precisão os números de telefone em todo o mundo e recupere uma combinação de detalhes de tipo de linha e operadora com dados de análise de risco para avaliar a reputação do número de telefone. O IPQS coleta dados de validação e verificação de telefone de uma ampla variedade de operadoras e provedores de telecomunicações de nível 1, com suporte para todas as regiões. Detecte números de telefone inativos e desconectados para facilitar a validação do usuário semelhante às pesquisas HLR &LRN. Identifique com precisão números de telefone virtuais e descartáveis, juntamente com números associados a comportamentos abusivos online. |
Recuperar dados de reputação de domínio (ou URL)
Verifica links e domínios em tempo real para detectar URLs suspeitas usando modelos confiáveis de machine learning. Esses modelos de machine learning podem identificar com precisão links de phishing, URLs de malware, vírus, domínios estacionados e URLs suspeitas com pontuações de risco em tempo real. Além disso, os modelos de machine learning podem classificar com confiança domínios de má reputação, links suspeitos e URLs de phishing com uma integração de API em tempo real. Recursos como detecção de domínio de estacionamento, pontuações de spam de domínio, verificações de reputação e idade do domínio, eleva a inteligência de URL a um nível totalmente novo.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Domínio de URL (ou)
|
url | True | string |
URL (ou) Domínio que você deseja buscar dados de reputação. |
|
Rigorosidade
|
strictness | True | integer |
Qual é o estrito de verificação dessa URL? Verificações mais rigorosas podem fornecer uma taxa de falso positivo mais alta. É recomendável usar o padrão para nivelar "0", a configuração de restrição mais baixa e aumentar para "1" ou "2", dependendo dos níveis de abuso. |
|
Rápido
|
fast | boolean |
Quando habilitada, a API fornecerá tempos de resposta mais rápidos usando verificações e análises mais leves. Essa configuração usa como padrão False. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Message
|
message | string |
Uma mensagem de status genérico, êxito ou alguma forma de aviso de erro. |
|
Êxito
|
success | boolean |
A solicitação foi bem-sucedida? |
|
Inseguro
|
unsafe | boolean |
Esse domínio é suspeito de não ser seguro devido a phishing, malware, spam ou comportamento abusivo? Exiba o nível de confiança analisando o "risk_score". |
|
Domínio
|
domain | string |
Nome de domínio da URL de destino final do link verificado, depois de seguir todos os redirecionamentos. |
|
Servidor
|
server | string |
A faixa do servidor do endereço IP do domínio. Por exemplo: "nginx/1.16.0". O valor será "N/A" se não estiver disponível. |
|
Tipo de conteúdo
|
content_type | string |
Tipo MIME do conteúdo da URL. Por exemplo, "text/html; charset=UTF-8". O valor será "N/A" se não estiver disponível. |
|
Código de status
|
status_code | integer |
Código de status HTTP da resposta da URL. Esse valor deve ser "200" para um site válido. O valor será "0" se a URL for inacessível. |
|
Tamanho da Página
|
page_size | integer |
Número total de bytes para baixar o conteúdo da URL. O valor será "0" se a URL for inacessível. |
|
Classificação de Domínio
|
domain_rank | integer |
Classificação de popularidade estimada do site globalmente. O valor será "0" se o domínio não for classificado ou tiver tráfego baixo. |
|
DNS válido
|
dns_valid | boolean |
O domínio da URL tem registros DNS válidos. |
|
Estacionamento
|
parking | boolean |
O domínio dessa URL está atualmente estacionado com um aviso de venda? |
|
Spamming
|
spamming | boolean |
O domínio dessa URL está associado a spam de email ou endereços de email abusivos? |
|
Software malicioso
|
malware | boolean |
Essa URL está associada a malware ou vírus? |
|
Phishing
|
phishing | boolean |
Essa URL está associada ao comportamento de phishing mal-intencionado? |
|
Suspeito
|
suspicious | boolean |
Essa URL é suspeita de ser mal-intencionada ou usada para phishing ou abuso? Use em conjunto com o "risk_score" como um nível de confiança. |
|
Adulto
|
adult | boolean |
Essa URL ou domínio está hospedando conteúdo de namoro ou adulto? |
|
Pontuação de risco
|
risk_score | integer |
A pontuação de risco do IPQS que estima o nível de confiança para detecção de URL mal-intencionada. As Pontuações de Risco 85+ são de alto risco, enquanto as Pontuações de Risco = 100 são confirmadas como precisas. |
|
Categoria
|
category | string |
Classificação de site e categoria relacionada ao conteúdo e setor do site. Mais de 70 categorias estão disponíveis, incluindo "Streaming de Vídeo", "Rastreadores", "Jogos", "Privacidade", "Publicidade", "Hacking", "Mal-intencionado", "Phishing" etc. O valor será "N/A" se desconhecido. |
|
Idade do Domínio Humano
|
domain_age.human | string |
Uma descrição humana de quando esse domínio foi registrado. (Ex: 3 meses atrás) |
|
Carimbo de data/hora da idade do domínio
|
domain_age.timestamp | integer |
O tempo de unix desde a época em que esse domínio foi registrado pela primeira vez. (Ex: 1568061634) |
|
ISO da Idade do Domínio
|
domain_age.iso | string |
A hora em que esse domínio foi registrado no formato ISO8601 (Ex: 2019-09-09T16:40:34-04:00) |
|
ID da solicitação
|
request_id | string |
Um identificador exclusivo para essa solicitação |
Recuperar dados de reputação de endereço de email
Essa API fornece pontuação e validação de reputação de endereço de email em tempo real com centenas de verificações de sintaxe &DNS. A API pode ser aproveitada para determinar se a caixa de entrada do endereço de email existe com o provedor de serviços de email e é capaz de aceitar novas mensagens. Além disso, os usuários podem determinar se o endereço de email tem uma reputação ruim ou se foi recentemente associado a abusos ou ameaças. A pontuação de risco adicional pode detectar serviços de email descartáveis e temporários, bem como emails com um histórico de comportamento fraudulento online.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Endereço de email
|
True | string |
Endereço de email que você deseja buscar dados de reputação. |
|
|
Restrição de abuso
|
abuse_strictness | True | integer |
Defina o nível de rigidez para o reconhecimento de padrões de machine learning de endereços de email abusivos com o ponto de dados "recent_abuse". O nível padrão 0 fornece uma boa cobertura, no entanto, se você estiver filtrando aplicativos de conta e enfrentando fraudadores avançados, recomendamos aumentar esse valor para o nível 1 ou 2. |
|
Rápido
|
fast | boolean |
Quando esse parâmetro estiver habilitado, nossa API não executará uma verificação SMTP com o provedor de serviços de email, o que aumenta muito a velocidade da API. As verificações de sintaxe e DNS ainda são executadas no endereço de email, bem como em nosso serviço de detecção de email descartável. Essa opção destina-se a serviços que exigem a tomada de decisões de maneira sensível ao tempo. |
|
|
Tempo limite em segundos (1-60)
|
timeout | integer |
Número máximo de segundos para aguardar uma resposta de um provedor de serviços de email. Se os requisitos de implementação não precisarem de uma resposta imediata, recomendamos aumentar esse valor para 20. Todos os resultados que experimentarem um tempo limite de conexão retornarão a variável "timed_out" como true. O valor padrão é 7 segundos. |
|
|
Sugerir Domínio
|
suggest_domain | boolean |
Force a análise se o domínio de endereços de email tem um erro de digitação e deve ser corrigido para um serviço de email popular. Por padrão, esse teste só é executado quando o email é inválido ou se o status de "abuso recente" é verdadeiro. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Message
|
message | string |
Uma mensagem de status genérico, êxito ou alguma forma de aviso de erro. |
|
Êxito
|
success | boolean |
A solicitação foi bem-sucedida? |
|
Válido
|
valid | boolean |
Esse endereço de email parece válido? |
|
Descartável
|
disposable | boolean |
Este email é suspeito de pertencer a um serviço de email temporário ou descartável? Normalmente associado a fraudadores e golpistas. |
|
Pontuação de SMTP
|
smtp_score | integer |
Pontuação de validade da configuração do SMTP do servidor de email. Intervalo: "-1" – "3". As pontuações acima de "-1" podem ser associadas a um email válido. -1 = endereço de email inválido 0 = o servidor de email existe, mas está rejeitando todos os emails 1 = o servidor de email existe, mas está mostrando um erro temporário 2 = o servidor de email existe, mas aceita todos os emails 3 = o servidor de email existe e verificou o endereço de email |
|
Pontuação geral
|
overall_score | integer |
Pontuação geral de validade de email. Intervalo: "0" – "4". As pontuações acima de "1" podem ser associadas a um email válido. 0 = endereço de email inválido 1 = servidor de email válido e inacessível 2 = dns válido, erro de rejeição temporária de email 3 = dns válido, aceita todos os emails 4 = dns válidos, o email verificado existe |
|
Primeiro Nome
|
first_name | string |
Nome suspeito com base no email. Retornará "CORPORATE" se o email for suspeito de ser um email genérico da empresa. Retornará "UNKNOWN" se o nome não for determinável. |
|
Genérico
|
generic | boolean |
Esse email é suspeito de ser um email catch all ou compartilhado para um domínio? ("admin@", "webmaster@", "newsletter@", "sales@", "contact@", etc.) |
|
Common
|
common | boolean |
Este email é de um provedor de email comum? ("gmail.com", "yahoo.com", "hotmail.com", etc.) |
|
DNS válido
|
dns_valid | boolean |
O nome do host do email tem entradas DNS válidas? Indicação parcial de um email válido. |
|
Honeypot
|
honeypot | boolean |
Acredita-se que este email seja um "honeypot" ou uma "armadilha de SPAM"? O email em massa enviado a esses emails aumenta o risco de ser colocado na lista negra por GRANDES ISPs e acabar na pasta de spam. |
|
Deliverability
|
deliverability | string |
Qual é a probabilidade de esse email ser entregue ao usuário e pousar em sua caixa de correio. Os valores podem ser "alto", "médio" ou "baixo". |
|
Reclamador Frequente
|
frequent_complainer | boolean |
Indica se esse email frequentemente cancela assinaturas de listas de marketing ou relatórios de email como SPAM. |
|
Pontuação de interceptação de spam
|
spam_trap_score | string |
Nível de confiança do endereço de email sendo uma armadilha de SPAM ativa. Os valores podem ser "alto", "médio", "baixo" ou "nenhum". Recomendamos esfregar emails com status "alto" ou "médio". Evite emails "baixos" sempre que possível para correspondências promocionais. |
|
Capturar Tudo
|
catch_all | boolean |
É provável que esse email seja um "catch all" em que o servidor de email verifica todos os emails testados nele como válidos? É difícil determinar se o endereço é realmente válido nesses cenários, pois o servidor do email não confirmará o status da conta. |
|
Tempo limite limite
|
timed_out | boolean |
A conexão com o provedor de serviços de email atingiu o tempo limite durante a verificação? Nesse caso, recomendamos aumentar a variável "tempo limite" acima do valor padrão de 7 segundos. Pesquisas que têm um tempo limite com um resultado "válido" como false provavelmente são falsas e não devem ser confiáveis. |
|
Suspeitar
|
suspect | boolean |
Esse valor indica se o servidor de email está respondendo com um erro temporário e não consegue verificar o endereço de email. Esse status também será verdadeiro para "capturar todos" endereços de email, conforme definido abaixo. Se esse valor for verdadeiro, suspeitaremos que o resultado "válido" possa ser corrompido e não há uma garantia de que o endereço de email seja realmente válido. |
|
Abuso recente
|
recent_abuse | boolean |
Esse valor indicará se houve algum abuso verificado recentemente em nossa rede para esse endereço de email. O abuso pode ser um retorno de acusação confirmado, inscrição falsa, dispositivo comprometido, instalação de aplicativo falso ou comportamento mal-intencionado semelhante nos últimos dias. |
|
Pontuação de fraude
|
fraud_score | integer |
A pontuação geral de fraude do usuário com base na reputação do email e no comportamento recente em toda a rede de ameaças do IPQS. Pontuações >de fraude = 75 são suspeitas, mas não necessariamente fraudulentas. |
|
Domínio Sugerido
|
suggested_domain | string |
O valor padrão é "N/A". Indica se o domínio desse email deve de fato ser corrigido para um serviço de email popular. Esse campo é útil para capturar erros de digitação do usuário. Por exemplo, um endereço de email com "gmai.com", exibiria um domínio sugerido de "gmail.com". Esse recurso dá suporte a todos os principais provedores de serviços de email. |
|
Vazou
|
leaked | boolean |
Esse endereço de email foi associado a um recente vazamento de banco de dados de terceiros? As contas vazadas representam um risco, pois podem ter sido comprometidas durante uma violação de banco de dados. |
|
Idade do Domínio Humano
|
domain_age.human | string |
Uma descrição humana de quando esse domínio foi registrado. (Ex: 3 meses atrás) |
|
Carimbo de data/hora da idade do domínio
|
domain_age.timestamp | integer |
Tempo de unix desde a época em que esse domínio foi registrado pela primeira vez (Ex: 1568061634). |
|
ISO da Idade do Domínio
|
domain_age.iso | string |
O domínio de tempo foi registrado no formato ISO8601(Ex: 2019-09-09T16:40:34-04:00). |
|
FirstSeen Human
|
first_seen.human | string |
Uma descrição humana da idade do endereço de email, usando uma estimativa da data de criação do email quando o IPQS descobriu esse endereço de email pela primeira vez. (Ex: 3 meses atrás) |
|
Carimbo de data/hora FirstSeen
|
first_seen.timestamp | integer |
O tempo de unix desde a época em que esse email foi analisado pela primeira vez pelo IPQS. (Ex: 1568061634) |
|
FirstSeen ISO
|
first_seen.iso | string |
A vez em que este email foi analisado pela primeira vez pelo IPQS no formato ISO8601 (ex: 2019-09T16:40:34-04:00). |
|
Email sanitizado
|
sanitized_email | string |
Endereço de email higienizado com todos os aliases e mascaramento removidos, como vários períodos para Gmail.com. |
|
ID da solicitação
|
request_id | string |
Um identificador exclusivo para essa solicitação. |
Recuperar dados de reputação de endereço IP
Esse serviço executa pesquisas em tempo real para determinar instantaneamente o quão arriscado um usuário, clique ou transação é baseado em um endereço IP e informações opcionais do dispositivo. Além de analisar se o endereço IP é um proxy ou VPN, a API retorna mais de 20 pontos de dados relevantes, como dados de localização geográfica, ISP, tipo de conexão, detalhes do dispositivo, atividade de reputação recente, pontuação geral de fraude, Status como proxy, VPN ou conexão TOR, Velocidade de Abuso, Outros pontos de dados semelhantes para classificar a reputação e o risco.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
endereço IP
|
ip | True | string |
Endereço IP que você deseja buscar dados de reputação. |
|
Rigorosidade
|
strictness | True | integer |
Qual é a profundidade (estrita) que deseja que essa consulta seja? Valores mais altos levam mais tempo para serem processados e podem fornecer uma taxa false-positiva mais alta. É recomendável começar em "0", a configuração de restrição mais baixa e aumentar para "1" ou "2", dependendo dos níveis de fraude. |
|
Agente do usuário
|
user_agent | string |
Opcionalmente, você pode nos fornecer a cadeia de caracteres do agente do usuário (navegador). Isso nos permite executar verificações adicionais para ver se o usuário é um bot ou executando um navegador inválido. Isso nos permite avaliar o risco do usuário, conforme julgado no "fraud_score". |
|
|
Idioma do Usuário
|
user_language | string |
Opcionalmente, você pode nos fornecer o cabeçalho de idioma do usuário. Isso nos permite avaliar o risco do usuário, conforme julgado no "fraud_score". |
|
|
Rápido
|
fast | boolean |
Quando esse parâmetro estiver habilitado, nossa API não executará determinadas verificações forenses que levam mais tempo para serem processadas. Habilitar esse recurso aumenta muito a velocidade da API sem muito impacto na precisão. Essa opção destina-se a serviços que exigem tomadas de decisão de maneira sensível ao tempo e podem ser usados para qualquer nível de restrição. |
|
|
Telemóvel
|
mobile | boolean |
Opcionalmente, você pode especificar que essa pesquisa deve ser tratada como um dispositivo móvel. Recomendado para pesquisas móveis que não têm um agente de usuário anexado à solicitação. NOTE-This podem causar resultados inesperados e anormais se o dispositivo não for um dispositivo móvel. |
|
|
Permitir pontos de acesso públicos
|
allow_public_access_points | boolean |
Ignora determinadas verificações de endereços IP de instituições de educação e pesquisa, escolas e algumas conexões corporativas para acomodar melhor o público que frequentemente usa conexões públicas. |
|
|
Penalidades mais leves
|
lighter_penalties | boolean |
Ignore algumas listas negras que podem causar falsos positivos para audiências confidenciais. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Êxito
|
success | boolean |
A solicitação foi bem-sucedida? |
|
Message
|
message | string |
Uma mensagem de status genérico, êxito ou alguma forma de aviso de erro. |
|
Pontuação de fraude
|
fraud_score | integer |
A pontuação geral de fraude do usuário com base no IP, agente do usuário, idioma e quaisquer outras variáveis passadas opcionalmente. Pontuações >de fraude = 75 são suspeitas, mas não necessariamente fraudulentas. Recomendamos sinalizar ou bloquear o tráfego com Pontuações >de Fraude = 85, mas você pode achar benéfico usar um limite maior ou inferior. |
|
Código do país
|
country_code | string |
Código de país de dois caracteres de endereço IP ou "N/A" se desconhecido. |
|
Região
|
region | string |
Região (estado) do endereço IP se disponível ou "N/A" se desconhecido. |
|
City
|
city | string |
Endereço IP da cidade, se disponível ou "N/A", se desconhecido. |
|
ISP
|
ISP | string |
ISP se um for conhecido. Caso contrário, "N/A". |
|
ASN
|
ASN | integer |
Número do sistema autônomo se um for conhecido. Nulo se inexistente. |
|
Organização
|
Organization | string |
Organização se um for conhecido. Pode ser a empresa-mãe ou a sub-empresa do ISP listado. Caso contrário, "N/A". |
|
É Rastreador
|
is_crawler | boolean |
Esse IP está associado a ser um rastreador confirmado de um mecanismo de pesquisa mainstream, como Googlebot, Bingbot, Yandex etc. com base no nome do host ou na verificação de endereço IP. |
|
Timezone
|
timezone | string |
Fuso horário do endereço IP, se disponível ou "N/A", se desconhecido. |
|
Telemóvel
|
mobile | boolean |
Esse agente de usuário é um navegador móvel? (sempre será falso se o agente de usuário não for passado na solicitação de API) |
|
Host
|
host | string |
Nome do host do endereço IP se houver um disponível. |
|
Proxy
|
proxy | boolean |
Suspeita-se que esse endereço IP seja um proxy? (SOCKS, Elite, Anônimo, VPN, Tor, etc.) |
|
VPN
|
vpn | boolean |
Esse IP é suspeito de ser uma conexão VPN? Isso pode incluir intervalos de data center que podem se tornar VPNs ativas a qualquer momento. O status de "proxy" sempre será verdadeiro quando esse valor for verdadeiro. |
|
TOR
|
tor | boolean |
Esse IP é suspeito de ser uma conexão TOR? Isso pode incluir nós TOR ativos anteriormente e saídas que podem se tornar saídas ativas do TOR a qualquer momento. O status de "proxy" sempre será verdadeiro quando esse valor for verdadeiro. |
|
VPN ativa
|
active_vpn | boolean |
Recurso de Conta Premium – identifica conexões VPN ativas usadas por serviços VPN populares e servidores VPN privados. |
|
TOR ativo
|
active_tor | boolean |
Recurso de Conta Premium – Identifica saídas ativas do TOR na rede TOR. |
|
Abuso recente
|
recent_abuse | boolean |
Esse valor indicará se houve algum abuso verificado recentemente em nossa rede para esse endereço IP. O abuso pode ser um chargeback confirmado, um dispositivo comprometido, uma instalação de aplicativo falsa ou um comportamento mal-intencionado semelhante nos últimos dias. |
|
Bot Status
|
bot_status | boolean |
Recurso de Conta Premium – Indica se bots ou tráfego não humano usaram recentemente esse endereço IP para se envolver em um comportamento fraudulento automatizado. Fornece uma confiança mais forte de que o endereço IP é suspeito. |
|
Tipo de Conexão
|
connection_type | string |
Classificação do tipo de conexão de endereço IP como "Residencial", "Corporativo", "Educação", "Móvel" ou "Data Center". |
|
Velocidade de abuso
|
abuse_velocity | string |
Recurso de Conta Premium – com que frequência o endereço IP está se envolvendo em abusos na rede de ameaças do IPQS. Os valores podem ser "alto", "médio", "baixo" ou "nenhum". Pode ser usado em combinação com a Pontuação de Fraude para identificar o mau comportamento. |
|
Latitude
|
latitude | float |
Latitude do endereço IP se disponível ou "N/A" se desconhecido. |
|
Longitude
|
longitude | float |
Longitude do endereço IP se disponível ou "N/A" se desconhecido. |
|
ID da solicitação
|
request_id | string |
Um identificador exclusivo para essa solicitação que pode ser usado para pesquisar os detalhes da solicitação ou enviar um aviso de conversão de postback. |
Recuperar dados de reputação do Número de Telefone
Verifique com precisão os números de telefone em todo o mundo e recupere uma combinação de detalhes de tipo de linha e operadora com dados de análise de risco para avaliar a reputação do número de telefone. O IPQS coleta dados de validação e verificação de telefone de uma ampla variedade de operadoras e provedores de telecomunicações de nível 1, com suporte para todas as regiões. Detecte números de telefone inativos e desconectados para facilitar a validação do usuário semelhante às pesquisas HLR &LRN. Identifique com precisão números de telefone virtuais e descartáveis, juntamente com números associados a comportamentos abusivos online.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Número de Telefone
|
phone | True | string |
Número de Telefone que você deseja buscar dados de reputação. |
|
Rigorosidade
|
strictness | True | integer |
Qual é a profundidade (estrita) que deseja que essa verificação de reputação seja? Verificações mais rigorosas podem fornecer uma taxa de falso positivo mais alta. É recomendável começar em "0", a configuração de restrição mais baixa e aumentar para "1" ou "2", dependendo dos níveis de fraude. |
|
País(Para vários países, forneça valores separados por vírgulas)
|
country | string |
Opcionalmente, você pode nos fornecer o país ou países padrão (separados por vírgula) com o qual se suspeita que esse número de telefone esteja associado. Nosso sistema preferirá usar um país nesta lista para verificação ou exigirá que um país seja especificado caso o número de telefone seja menor que 10 dígitos. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Message
|
message | string |
Uma mensagem de status genérico, êxito ou alguma forma de aviso de erro. |
|
Êxito
|
success | boolean |
A solicitação foi bem-sucedida? |
|
Formatado
|
formatted | string |
O número de telefone formatado no código de discagem internacional. N/A se não for formatável. |
|
Formato local
|
local_format | string |
O número de telefone formatado nas regras de roteamento local do país com código de área. N/A se não for formatável. |
|
Válido
|
valid | boolean |
O número de telefone é formatado corretamente e considerado válido com base nos números de telefone atribuídos disponíveis para as operadoras desse país? |
|
Pontuação de fraude
|
fraud_score | integer |
A pontuação de risco do IPQS que estima a probabilidade de um número de telefone ser fraudulento. As pontuações 85+ são de alto risco. |
|
Abuso recente
|
recent_abuse | boolean |
Esse número de telefone foi associado a fraudes recentes ou contínuas? |
|
VOIP
|
VOIP | boolean |
Esse número de telefone é um VOIP (Voice Over Internet Protocol) ou um número de telefone digital? |
|
Pré-pago
|
prepaid | boolean |
Esse número de telefone está associado a um plano de serviço pré-pago? |
|
Arriscado
|
risky | boolean |
Esse número de telefone está associado a atividades fraudulentas, golpes, chamadas robo, contas falsas ou outro comportamento hostil? |
|
Active
|
active | boolean |
Esse número de telefone é um número de telefone utilizável que está ativo no momento? |
|
Portador
|
carrier | string |
A operadora (provedor de serviços) a qual esse número de telefone foi atribuído ou "N/A", se desconhecido. |
|
Tipo de linha
|
line_type | string |
O tipo de linha à qual esse número de telefone está associado (Ligação Gratuita, Móvel, Telefone Fixo, Satélite, VOIP, Taxa Premium, Pager etc...) ou "N/A", se desconhecido. |
|
País
|
country | string |
O código do país de dois caracteres para esse número de telefone. |
|
City
|
city | string |
Cidade do número de telefone, se disponível ou "N/A", se desconhecido. |
|
Código Postal
|
zip_code | string |
Cep ou cep do número de telefone, se disponível ou "N/A", se desconhecido. |
|
Região
|
region | string |
Região (estado) do número de telefone se disponível ou "N/A" se desconhecido. |
|
Código de discagem
|
dialing_code | integer |
O código de discagem de 1 a 4 dígitos para esse número de telefone ou nulo, se desconhecido. |
|
ID da solicitação
|
request_id | string |
Um identificador exclusivo para essa solicitação |
|
Nome
|
name | string |
O nome do proprietário do número de telefone, como nome ou sobrenome ou nome comercial atribuído ao número de telefone. Vários nomes serão retornados em formato separado por vírgulas. O valor será "N/A" se desconhecido. |
|
Timezone
|
timezone | string |
Fuso horário do número de telefone, se disponível ou "N/A", se desconhecido. |
|
Não chamar
|
do_not_call | boolean |
Indica se o número de telefone está listado em qualquer lista do DNC (Não Chamar). Só há suporte nos EUA e na AC. Esses dados podem não estar 100% atualizados com as listas negras mais recentes do DNC. |
|
Status Ativo
|
active_status | string |
Detalhes adicionais sobre o status da conexão do assinante quando as verificações de linha ativas aprimoradas estiverem habilitadas. Esses valores podem ser "Linha Ativa", "Linha Desconectada", "Telefone Desativado", "Status Inconclusivo" ou "N/A", se desconhecido. |