API för analys och validering av telefonnummer

Category Identitet och verifiering

Slutpunkter 2

Nyckelfunktioner 7

Vanliga frågor 5

Används av människor på fantastiska företag

Förtroendesignaler före integration

Transparent dokumentation, autentiserade anrop och synliga tillförlitlighetsdetaljer gör DomScan lättare att utvärdera före lansering.

I drift Tjänstestatus

Kontrollera tjänstens aktuella status och dokumenterade felsvar innan du integrerar.

OpenAPI API-material

OpenAPI, Swagger, Postman, CLI, SDK och MCP-länkar finns ett klick bort.

API-nycklar Skyddad åtkomst

Autentiserade endpoints använder API-nycklar med tydliga kreditkostnader före anrop.

10,000 Gratis kvot

Börja med 10 000 krediter per månad och uppgradera först när användningen växer.

Vad detta API hjälper dig att leverera

Använd sidan som en produktionsbrief: endpoints, exempel, responsform och workflow-delar som krävs för att koppla DomScan till din produkt.

Produktworkflows

Bädda in domänkontroller, DNS-intelligence, risksignaler eller berikning i onboarding, sök och interna verktyg.

Analystautomatisering

Ersätt upprepade manuella lookups med schemalagda jobb, alerts och reproducerbara utredningssteg.

Ren JSON-data

Använd förutsägbara fält, dokumenterade statuskoder och kreditkostnader istället för att skrapa leverantörssidor.

AI- och ops-verktyg

Mata agenter, dashboards, SOAR-playbooks och CRM:er via OpenAPI, SDK, Postman eller MCP.

Integrationsworkflow

En enkel väg från första request till repeterbar produktion.

Autentisera en gång

Skicka din API-nyckel med dokumenterad header och håll requests konsekventa mellan tjänster.

Fråga med exempel

Börja med curl- och HTTP-exempel och mappa sedan parametrarna till din applikationskod.

Drifta och övervaka

Använd statuskoder, kreditkostnader och responsfält för retries, loggar och alerts.

Utvecklarkit

Gå från sidan till maskinläsbara docs, request-samlingar, SDK:er eller agentverktyg.

OpenAPI-schema

Generera klienter eller inspektera varje request- och responsform.

Postman-samling

Importera färdiga requests för manuell testning och teamöverlämning.

SDK:er och CLI

Använd underhållna paket och command-line workflows istället för boilerplate.

MCP-integration

Exponera domänintelligence för AI-agenter och interna assistentworkflows.

Parameter- och responskarta

Granska inputs, outputfält och statuskoder innan endpointen kopplas in i din klient.

Requestparametrar

Parameter

phonedefault_countryexpected_countrydialing_from_countrylanguagephones

Responsfält

Exempelsvar

inputnormalized_inputkindvalidpossiblestatusrecommendationvalidation_levelreasonwarningsnumbernumber.e164

Statustäckning

HTTP-statuskoder

200400401402429500

Slutpunkter

POST /v1/phone/validate

Krediter: 1Autentisering: Autentisering krävs

phonedefault_countryexpected_countrydialing_from_countrylanguage

POST /v1/phone/validate/bulk

Krediter: 1/itemAutentisering: Autentisering krävs

phonesdefault_countryexpected_countrydialing_from_countrylanguage

Validera först. Betala för aktuella telekomuppgifter bara när de behövs.

DomScan hanterar det första steget med validering mot nummerplanen, standardformat, offlinemetadata och, där det finns täckning, officiella belägg för nummerserie eller prefix. Filtrera och styr numren först och lägg sedan till en separat tjänst med aktuella uppgifter endast när beslutet kräver information om nuvarande operatör eller portering, nåbarhet, behörig identitetsverifiering eller leverantörsspecifika bedrägerisignaler.

En kredit per nummer

Kör vanliga kontroller mot nummerplanen för varje nummer innan du avgör vilka poster som motiverar en aktuell nätverksfråga.

Ingen telekomfråga per nummer

DomScan kontrollerar format, dokumenterade nummerserier och offlinemetadata. En plats är ett område i nummerplanen, inte en fysisk position. En operatör eller tilldelningsinnehavare är seriens ursprungliga koppling, inte nödvändigtvis den nuvarande operatören efter portering. Resultatet bekräftar inte tilldelning, aktivitet, nåbarhet, sms-leverans eller abonnentidentitet.

Officiell tilldelningsinformation

Där täckning finns visas status för den matchande nummerserien och den ursprungliga tilldelningsinnehavaren, tillsammans med uppgifter om källa och ögonblicksbild. Informationen beskriver en nummerserie och identifierar inte nuvarande operatör eller abonnent.

Förtroendesignaler före integration

Transparent dokumentation, autentiserade anrop och synliga tillförlitlighetsdetaljer gör DomScan lättare att utvärdera före lansering.

Tjänstestatus API-material

OpenAPI, Swagger, Postman, CLI, SDK och MCP-länkar finns ett klick bort.

API-nycklar Skyddad åtkomst

Autentiserade endpoints använder API-nycklar med tydliga kreditkostnader före anrop.

Gratis kvot Registrera dig Gratis

Börja med 10 000 krediter per månad och uppgradera först när användningen växer.

Aktiv Exempelbegäran

Börja med curl- och HTTP-exempel och mappa sedan parametrarna till din applikationskod.

Nyckelfunktioner

Strikt validering mot nummerplan

Kontrollera längd och siffermönster mot fullständiga nummerplansmetadata, inte enbart längden.

Standardiserade format

Returnera formaten E.164, internationellt, nationellt och RFC 3966, inklusive tolkade anknytningar.

Möjligt respektive giltigt

Skilj nummer med en rimlig längd från nummerserier som nummerplanen känner igen.

Nummertyp och prefixanalys

Identifiera nummertyp, plats enligt nummerplanen, möjliga tidszoner, ursprunglig prefixoperatör och stöd för nummerportabilitet när dessa uppgifter finns i metadata.

Landsanpassad uppringning och kortnummer

Tolka nationella nummer med ett angivet land, skapa ett uppringningsformat för samtalets ursprungsland och identifiera regionala kortnummer och larmnummer.

Massvalidering

Validera upp till 100 nummer per begäran med ett separat resultat för varje inmatat värde.

Offlinekällor och officiella tilldelningar

Exempelbegäran

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

Exempelsvar

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
}

Vanliga frågor

Vad innebär det att ett telefonnummer är giltigt?

Giltigt innebär att numret överensstämmer med den dokumenterade längden och de dokumenterade siffermönstren för en nummerserie som nummerplanen känner igen. Det innebär inte att numret har tilldelats en abonnent.

Bevisar valideringen att numret är aktivt eller nåbart?

Nej. Validering mot nummerplanen kan inte bekräfta att ett nummer är tilldelat, aktivt, nåbart eller kan ta emot samtal eller sms.

Returnerar API:t den nuvarande operatören eller telefonens ägare?

API:t kan returnera en ursprunglig prefixoperatör eller innehavaren av en myndighetstilldelning. Inget av fälten anger nödvändigtvis den nuvarande operatören efter en nummerportering, och inget av dem identifierar abonnenten eller telefonens ägare.

Kräver nationella telefonnummer ett land?

Ja. Ange ett förvalt land eller en förvald region när numret inte börjar med en internationell landskod. Ett land krävs också för att tolka regionala kortnummer och larmnummer.

Kan jag validera telefonnummer i större mängder?

Ja. Endpointen för massvalidering tar emot upp till 100 nummer och returnerar resultaten i samma ordning som inmatningen. Om offlineberikningen inte är tillgänglig slutförs den lokala valideringen ändå och intelligence.status redovisar reservlösningen.

Relaterade verktyg och resurser

HTTP-statuskoder

Vi dokumenterar de HTTP-statuskoder som din klient bör hantera så att du kan skilja mellan lyckade svar, autentiseringsproblem, krediter, hastighetsgränser, saknade data och upstream-fel.

OK 200

Begäran lyckades

Felaktig begäran 400

Ogiltiga parametrar

Obehörig 401

API-nyckel eller session saknas eller är ogiltig.

Betalning krävs 402

Det finns inte tillräckligt med krediter för att köra denna begäran.

För många begäranden 429

Hastighetsgränsen överskriden

Serverfel 500

Internt fel

Prova telefonnummeranalys kostnadsfritt

Borja gratis Visa dokumentation Prova gratisverktyget

Support

API för Telefonnummeranalys

Förtroendesignaler före integration

Vad detta API hjälper dig att leverera

Integrationsworkflow

Utvecklarkit

Parameter- och responskarta

Slutpunkter

Validera först. Betala för aktuella telekomuppgifter bara när de behövs.

Förtroendesignaler före integration

Nyckelfunktioner

Exempelbegäran

Exempelsvar

Vanliga frågor

Relaterade verktyg och resurser

HTTP-statuskoder