API di informazioni e validazione dei numeri di telefono

Categoria Sicurezza

Endpoint 2

Caratteristiche Principali 7

Domande Frequenti 6

Segnali di fiducia prima dell’integrazione

Documentazione trasparente, richieste autenticate e dettagli di affidabilità visibili rendono più semplice valutare DomScan prima del rilascio.

In tempo reale Stato del servizio

Controlla lo stato del servizio in tempo reale e le risposte di errore documentate prima dell’integrazione.

OpenAPI Artefatti API

OpenAPI, Swagger, Postman, CLI, SDK e link MCP sono a un clic.

Chiavi API Accesso protetto

Gli endpoint autenticati usano chiavi API con costi in crediti chiari prima della chiamata.

10,000 Quota gratuita

Inizia con 10.000 crediti mensili e fai upgrade solo quando l’uso cresce.

Cosa ti aiuta a costruire questa API

Usa questa pagina come brief di produzione: endpoint, esempi, forma della risposta e parti del workflow per integrare DomScan nel tuo prodotto.

Workflow di prodotto

Integra controlli dominio, intelligence DNS, segnali di rischio o arricchimento in onboarding, ricerca e strumenti interni.

Automazione per analisti

Sostituisci lookup manuali ripetuti con job pianificati, alert e passaggi di indagine riproducibili.

Dati JSON puliti

Usa campi prevedibili, codici di stato documentati e costi in crediti invece di fare scraping di pagine provider.

AI e strumenti ops

Alimenta agenti, dashboard, playbook SOAR e CRM tramite OpenAPI, SDK, Postman o MCP.

Workflow di integrazione

Un percorso semplice dalla prima richiesta all’uso ripetibile in produzione.

Autentica una volta

Invia la tua chiave API con l’header documentato e mantieni richieste coerenti tra servizi.

Interroga con esempi

Parti dagli esempi curl e HTTP, poi mappa i parametri nel codice della tua applicazione.

Opera e monitora

Usa codici di stato, costi in crediti e campi di risposta per costruire retry, log e alert.

Kit sviluppatori

Passa da questa pagina a docs leggibili da macchina, raccolte di richieste, SDK o strumenti per agenti.

Schema OpenAPI

Genera client o ispeziona ogni forma di richiesta e risposta.

Collezione Postman

Importa richieste pronte per test manuali e handoff al team.

SDK e CLI

Usa pacchetti mantenuti e workflow da riga di comando invece di scrivere boilerplate.

Integrazione MCP

Esponi intelligence sui domini ad agenti AI e assistenti interni.

Mappa di parametri e risposta

Controlla input, campi di output e codici di stato prima di collegare l’endpoint al tuo client.

Parametri richiesta

Parametro

phonedefault_countryexpected_countrydialing_from_countrylanguagephones

Campi risposta

Risposta di esempio

inputnormalized_inputkindvalidpossiblestatusrecommendationvalidation_levelreasonwarningsnumbernumber.e164

Copertura stati

Codici di stato HTTP

200400401402429500502503504

Endpoint

POST /v1/phone/validate

Crediti: 1Autenticazione: Autenticazione richiesta

phonedefault_countryexpected_countrydialing_from_countrylanguage

POST /v1/phone/validate/bulk

Crediti: 1Autenticazione: Autenticazione richiesta

phonesdefault_countryexpected_countrydialing_from_countrylanguage

Segnali di fiducia prima dell’integrazione

Documentazione trasparente, richieste autenticate e dettagli di affidabilità visibili rendono più semplice valutare DomScan prima del rilascio.

Stato del servizio Artefatti API

OpenAPI, Swagger, Postman, CLI, SDK e link MCP sono a un clic.

Chiavi API Accesso protetto

Gli endpoint autenticati usano chiavi API con costi in crediti chiari prima della chiamata.

Quota gratuita Iscriviti Gratuitamente

Inizia con 10.000 crediti mensili e fai upgrade solo quando l’uso cresce.

Attivo Richiesta di esempio

Parti dagli esempi curl e HTTP, poi mappa i parametri nel codice della tua applicazione.

Caratteristiche Principali

Validazione rigorosa del piano di numerazione

Verifica lunghezza e sequenze di cifre usando i metadati completi del piano di numerazione, non soltanto la lunghezza.

Formati standardizzati

Restituisce i formati E.164, internazionale, nazionale e RFC 3966, comprese le estensioni analizzate.

Possibile o valido

Distingue i numeri con una lunghezza plausibile dagli intervalli riconosciuti dal piano di numerazione.

Tipo di numero e informazioni sul prefisso

Identifica il tipo di numero, la località secondo il piano di numerazione, i possibili fusi orari, l’operatore originario del prefisso e il supporto alla portabilità quando i metadati lo consentono.

Composizione e numeri brevi in base al paese

Analizza i numeri nazionali specificando un paese, genera formati di composizione adatti al paese di origine e riconosce numeri brevi regionali e numeri di emergenza.

Validazione collettiva

Convalida fino a 100 numeri per richiesta e restituisce un risultato specifico per ogni valore in ingresso.

Fonti offline e assegnazioni ufficiali

Utilizza metadati offline e copie pubbliche dei dati delle autorità di regolamentazione sull’infrastruttura di DomScan. I risultati corrispondenti includono fonte, licenza, data di aggiornamento e contesto dell’assegnazione originaria.

Richiesta di esempio

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"}'

Risposta di esempio

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
}

Domande Frequenti

Cosa significa che un numero di telefono è valido?

Valido significa che il numero corrisponde alla lunghezza e alle sequenze di cifre documentate per un intervallo riconosciuto dal piano di numerazione. Non significa che il numero sia assegnato a un abbonato.

La validazione dimostra che il numero è attivo o raggiungibile?

No. La validazione del piano di numerazione non può confermare che un numero sia assegnato, attivo, raggiungibile o in grado di ricevere chiamate o SMS.

L’API restituisce l’operatore attuale o il proprietario del telefono?

L’API può restituire l’operatore originario del prefisso o il titolare dell’assegnazione dell’autorità di regolamentazione. Nessuno dei due campi indica l’operatore attuale dopo una portabilità, né identifica l’abbonato o il proprietario del telefono.

I numeri di telefono nazionali richiedono un paese?

Sì. Indica un paese o una regione predefiniti quando il numero non inizia con un prefisso telefonico internazionale. Il paese è necessario anche per interpretare numeri brevi regionali e numeri di emergenza.

Da dove provengono i dati informativi?

I metadati globali provengono da Google libphonenumber. I dati ufficiali relativi a intervalli e prefissi possono provenire anche da istantanee pubbliche diffuse da CNMC, ARCEP, Bundesnetzagentur, MIC Giappone, RTR Austria, Nkom, UKE Polonia, MODA Taiwan, NANPA per gli Stati Uniti e CNA/CNAC per il Canada. I dati statunitensi e canadesi descrivono lo stato dei codici di centrale NPA-NXX e i loro assegnatari originali, non l’operatore attuale di un numero oggetto di portabilità. Ogni risultato indica le fonti, le date delle istantanee e il livello di copertura. La località e i fusi orari descrivono il prefisso del piano di numerazione, non la posizione attuale del telefono.

Posso convalidare più numeri di telefono insieme?

Sì. L’endpoint collettivo accetta fino a 100 numeri e restituisce i risultati nello stesso ordine dei valori in ingresso. Se l’arricchimento offline non è disponibile, la validazione locale viene comunque completata e intelligence.status segnala il ripiego.

Strumenti e Risorse Correlati

Codici di stato HTTP

Documentiamo i codici di stato HTTP che il tuo client dovrebbe gestire per distinguere risposte riuscite, problemi di autenticazione, crediti, limiti di richiesta, dati mancanti ed errori upstream.

OK 200

Richiesta riuscita

Richiesta non valida 400

Parametri non validi

Non autorizzato 401

Chiave API o sessione mancante o non valida.

Pagamento richiesto 402

Crediti insufficienti per eseguire questa richiesta.

Troppe richieste 429

Limite di richieste superato

Errore del server 500

Errore interno

Gateway non valido 502

Errore RDAP upstream

Servizio non disponibile 503

Il servizio a monte non è disponibile o sta limitando temporaneamente le richieste.

Timeout del gateway 504

La richiesta al servizio a monte è scaduta.

Prova gratis le informazioni sui numeri di telefono

Visualizza Documentazione API Completa API

API di informazioni sui numeri di telefono

Segnali di fiducia prima dell’integrazione

Cosa ti aiuta a costruire questa API

Workflow di integrazione

Kit sviluppatori

Mappa di parametri e risposta

Endpoint

Segnali di fiducia prima dell’integrazione

Caratteristiche Principali

Richiesta di esempio

Risposta di esempio

Domande Frequenti

Strumenti e Risorse Correlati

Codici di stato HTTP