API de inteligência e validação de números de telefone

Categoria Seguranca

Pontos finais 2

Principais Recursos 7

Perguntas frequentes 6

Sinais de confiança antes da integração

Documentação transparente, solicitações autenticadas e detalhes visíveis de confiabilidade facilitam avaliar o DomScan antes de publicar.

Ao vivo Status do serviço

Consulte o estado do serviço ao vivo e as respostas de falha documentadas antes de fazer a integração.

OpenAPI Artefatos da API

OpenAPI, Swagger, Postman, CLI, SDK e links MCP ficam a um clique.

Chaves API Acesso protegido

Endpoints autenticados usam chaves API com custos de créditos claros antes da chamada.

10,000 Cota gratuita

Comece com 10.000 créditos mensais e faça upgrade só quando o uso crescer.

O que esta API ajuda você a lançar

Use esta página como briefing de produção: endpoints, exemplos, formato da resposta e peças de workflow para conectar o DomScan ao seu produto.

Workflows de produto

Incorpore checagens de domínio, inteligência DNS, sinais de risco ou enriquecimento em onboarding, busca e ferramentas internas.

Automação de analistas

Substitua consultas manuais repetidas por jobs agendados, alertas e etapas de investigação reproduzíveis.

Dados JSON limpos

Use campos previsíveis, códigos de status documentados e custos em créditos em vez de raspar páginas de fornecedores.

IA e operações

Alimente agentes, dashboards, playbooks SOAR e CRMs via OpenAPI, SDK, Postman ou MCP.

Fluxo de integração

Um caminho simples da primeira requisição ao uso repetível em produção.

Autentique uma vez

Envie sua chave API com o cabeçalho documentado e mantenha requisições consistentes entre serviços.

Consulte com exemplos

Comece pelos exemplos curl e HTTP, depois mapeie os parâmetros no código da sua aplicação.

Opere e monitore

Use códigos de status, custos em créditos e campos de resposta para criar retentativas, logs e alertas.

Kit de desenvolvedor

Saia desta página para docs legíveis por máquina, coleções de requisições, SDKs ou ferramentas para agentes.

Esquema OpenAPI

Gere clientes ou inspecione cada formato de requisição e resposta.

Coleção Postman

Importe requisições prontas para testes manuais e repasse ao time.

SDKs e CLI

Use pacotes mantidos e fluxos de linha de comando em vez de escrever boilerplate.

Integração MCP

Exponha inteligência de domínios para agentes de IA e assistentes internos.

Mapa de parâmetros e resposta

Revise entradas, campos de saída e códigos de status antes de ligar o endpoint ao seu cliente.

Parâmetros da requisição

Parâmetro

phonedefault_countryexpected_countrydialing_from_countrylanguagephones

Campos da resposta

Resposta de Exemplo

inputnormalized_inputkindvalidpossiblestatusrecommendationvalidation_levelreasonwarningsnumbernumber.e164

Cobertura de status

Códigos de Estado HTTP

200400401402429500502503504

Pontos finais

POST /v1/phone/validate

Créditos: 1Autenticação: Autenticação necessária

phonedefault_countryexpected_countrydialing_from_countrylanguage

POST /v1/phone/validate/bulk

Créditos: 1Autenticação: Autenticação necessária

phonesdefault_countryexpected_countrydialing_from_countrylanguage

Sinais de confiança antes da integração

Documentação transparente, solicitações autenticadas e detalhes visíveis de confiabilidade facilitam avaliar o DomScan antes de publicar.

Status do serviço Artefatos da API

OpenAPI, Swagger, Postman, CLI, SDK e links MCP ficam a um clique.

Chaves API Acesso protegido

Endpoints autenticados usam chaves API com custos de créditos claros antes da chamada.

Cota gratuita Cadastre-se Gratuitamente

Comece com 10.000 créditos mensais e faça upgrade só quando o uso crescer.

Ativo Pedido de Exemplo

Comece pelos exemplos curl e HTTP, depois mapeie os parâmetros no código da sua aplicação.

Principais Recursos

Validação rigorosa do plano de numeração

Verifique o comprimento e os padrões de dígitos com metadados completos do plano de numeração, não apenas o comprimento.

Formatos padronizados

Obtenha os formatos E.164, internacional, nacional e RFC 3966, incluindo ramais identificados.

Possível versus válido

Diferencie números com comprimento plausível de faixas reconhecidas pelo plano de numeração.

Tipo de número e inteligência do prefixo

Identifique o tipo de número, a localização segundo o plano de numeração, possíveis fusos horários, a operadora original do prefixo e o suporte à portabilidade quando os metadados permitirem.

Discagem e números curtos por país

Analise números nacionais com um país, gere formatos de discagem específicos para o país de origem e reconheça números curtos regionais e números de emergência.

Validação em massa

Valide até 100 números por requisição, com um resultado individual para cada entrada.

Fontes offline e atribuições oficiais

Use metadados offline e cópias públicas de dados regulatórios na infraestrutura da DomScan. Os resultados correspondentes incluem fonte, licença, data de atualização e contexto da atribuição original.

Pedido de Exemplo

POST /v1/phone/validate bash

curl -X POST https://domscan.net/v1/phone/validate \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"phone":"+34 612 345 678","expected_country":"ES","dialing_from_country":"US","language":"en"}'

Resposta de Exemplo

200 OK json

{
  "input": "+34 612 345 678",
  "normalized_input": "+34 612 345 678",
  "kind": "phone_number",
  "valid": true,
  "possible": true,
  "status": "valid",
  "recommendation": "accept",
  "validation_level": "numbering_plan",
  "reason": null,
  "warnings": [],
  "number": {
    "e164": "+34612345678",
    "international": "+34 612 34 56 78",
    "national": "612 34 56 78",
    "rfc3966": "tel:+34612345678",
    "national_number": "612345678",
    "extension": null,
    "country": "ES",
    "country_name": "Spain",
    "country_calling_code": "34",
    "possible_countries": ["ES"],
    "country_match": true,
    "type": "mobile",
    "non_geographic": false
  },
  "intelligence": {
    "status": "available",
    "kind": "phone_number",
    "coverage": {
      "country": "ES",
      "level": "official_allocation_match",
      "global_numbering_metadata": true,
      "official_snapshot_available": true,
      "official_allocation_match": true,
      "official_source_ids": ["cnmc"],
      "matching_source_ids": ["cnmc"],
      "current_carrier_lookup": false
    },
    "location": {
      "country_name": "Spain",
      "country": "ES",
      "granularity": "country",
      "current_physical_location": false
    },
    "possible_time_zones": {
      "values": ["Europe/Madrid"],
      "current_location": false,
      "inference": "number_prefix"
    },
    "original_prefix_carrier": {
      "name": "FOOTBALLERISTA MOBILE SPAIN, S.A. UNIPERSONAL",
      "source_id": "cnmc",
      "evidence": "official_allocation_record",
      "current_carrier": false,
      "portability_may_change_carrier": true
    },
    "portability": {
      "region_supported": true,
      "current_port_checked": false
    },
    "dialing": {
      "from_country": "US",
      "international": "011 34 612 34 56 78",
      "internationally_diallable": true
    },
    "regulator_allocations": [{
      "authority": "CNMC",
      "category": "mobile",
      "status": "assigned",
      "original_assignee": "FOOTBALLERISTA MOBILE SPAIN, S.A. UNIPERSONAL",
      "assigned_on": "2023-11-03",
      "current_operator": false,
      "individual_number_assignment_checked": false
    }],
    "sources": [{
      "id": "google_libphonenumber",
      "name": "Google libphonenumber metadata",
      "license": "Apache-2.0"
    }, {
      "id": "cnmc",
      "name": "Comisión Nacional de los Mercados y la Competencia (CNMC)",
      "type": "official_regulator_snapshot"
    }]
  },
  "live_checks": {
    "assignment": "not_checked",
    "reachability": "not_checked",
    "current_carrier": "not_checked",
    "subscriber_identity": "not_checked",
    "porting": "not_checked"
  },
  "privacy": {
    "upstream_requests": 0,
    "telecom_provider_queried": false,
    "persisted": false,
    "domscan_edge_relay_used": true,
    "third_party_requests": 0
  },
  "limitations": [
    "NUMBERING_PLAN_ONLY",
    "DOES_NOT_PROVE_ASSIGNMENT",
    "NO_LIVE_TELECOM_CHECKS"
  ],
  "credits_used": 1
}

Perguntas frequentes

O que significa um número de telefone válido?

Válido significa que o número corresponde ao comprimento e aos padrões de dígitos documentados de uma faixa reconhecida do plano de numeração. Isso não significa que o número esteja atribuído a um assinante.

A validação comprova que o número está ativo ou acessível?

Não. A validação do plano de numeração não pode confirmar que um número esteja atribuído, ativo, acessível ou apto a receber chamadas ou SMS.

A API retorna a operadora atual ou o proprietário do telefone?

A API pode retornar a operadora original do prefixo ou o titular da atribuição regulatória. Nenhum dos campos indica a operadora atual após a portabilidade, nem identifica o assinante ou proprietário do telefone.

Números de telefone nacionais exigem um país?

Sim. Informe um país ou região padrão quando o número não começar com um código telefônico internacional. Também é necessário informar um país para interpretar números curtos regionais e números de emergência.

De onde vêm os dados de inteligência?

Os metadados globais vêm do Google libphonenumber. As evidências oficiais de faixas e prefixos também podem vir de cópias públicas publicadas por CNMC, ARCEP, Bundesnetzagentur, MIC Japão, RTR Áustria, Nkom, UKE Polônia, MODA Taiwan, NANPA para os Estados Unidos e CNA/CNAC para o Canadá. Os registros dos Estados Unidos e do Canadá descrevem o status dos códigos de central NPA-NXX e seus titulares originais, não a operadora atual de um número portado. Cada resultado informa suas fontes, as datas das cópias e o nível de cobertura. A localização e os fusos horários descrevem o prefixo do plano de numeração, não a posição atual do telefone.

Posso validar números de telefone em massa?

Sim. O endpoint em massa aceita até 100 números e retorna os resultados na ordem de entrada. Se o enriquecimento offline não estiver disponível, a validação local ainda será concluída e intelligence.status informará o fallback.

Ferramentas e Recursos Relacionados

Códigos de Estado HTTP

Documentamos os códigos de estado HTTP que deves tratar para distinguir respostas bem-sucedidas, problemas de autenticação, créditos, limites de taxa, dados em falta e falhas do serviço a montante.

OK 200

Pedido bem-sucedido

Pedido inválido 400

Parâmetros inválidos

Não autorizado 401

Chave de API ou sessão em falta ou inválida.

Pagamento necessário 402

Não tens créditos suficientes para executar este pedido.

Demasiados pedidos 429

Limite de taxa excedido

Erro do servidor 500

Erro interno

Erro de gateway 502

Erro do serviço RDAP de origem

Serviço indisponível 503

O serviço a montante está indisponível ou a limitar temporariamente.

Tempo limite do gateway 504

A consulta ao serviço a montante expirou.

Experimente gratuitamente a inteligência de números de telefone

Ver Documentação Completa da API APIs

API de inteligência de números de telefone

Sinais de confiança antes da integração

O que esta API ajuda você a lançar

Fluxo de integração

Kit de desenvolvedor

Mapa de parâmetros e resposta

Pontos finais

Sinais de confiança antes da integração

Principais Recursos

Pedido de Exemplo

Resposta de Exemplo

Perguntas frequentes

Ferramentas e Recursos Relacionados

Códigos de Estado HTTP