Beveiliging 2 Endpoints 7 Belangrijkste functies

API voor telefoonnummerinformatie

Valideer nationale of internationale telefoonnummers, normaliseer de notatie en voeg nuttige offline context toe. Resultaten kunnen nummerplanlocatie, mogelijke tijdzones, de oorspronkelijke provider van het nummerblok, belinstructies, signalen voor verkorte nummers en overeenkomende openbare toewijzingen van toezichthouders bevatten, zonder betaalde telecomopzoeking.

Categorie Beveiliging
Endpoints 2
Belangrijkste functies 7
Veelgestelde vragen 6

Vertrouwenssignalen voordat je integreert

Transparante documentatie, geauthenticeerde requests en zichtbare betrouwbaarheidsdetails maken DomScan makkelijker te beoordelen voor livegang.

Live Servicestatus

Controleer vóór de integratie de live servicestatus en de gedocumenteerde foutreacties.

OpenAPI API-artifacts

OpenAPI, Swagger, Postman, CLI, SDK en MCP-links zijn één klik verwijderd.

API-sleutels Beschermde toegang

Geauthenticeerde endpoints gebruiken API-sleutels met duidelijke creditkosten voordat je ze aanroept.

10,000 Gratis tegoed

Begin met 10.000 maandelijkse credits en upgrade pas wanneer het gebruik groeit.

Wat deze API je helpt bouwen

Gebruik deze pagina als productiebriefing: endpoints, voorbeelden, responsstructuur en workflow-onderdelen om DomScan in je product te koppelen.

Productworkflows

Integreer domeinchecks, DNS-intelligence, risicosignalen of verrijking in onboarding, zoeken en interne tools.

Analistautomatisering

Vervang herhaalde handmatige lookups door geplande taken, alerts en reproduceerbare onderzoeksstappen.

Schone JSON-data

Gebruik voorspelbare velden, gedocumenteerde statuscodes en kredietkosten in plaats van providerpagina’s te scrapen.

AI- en ops-tools

Voed agents, dashboards, SOAR-playbooks en CRMs via OpenAPI, SDK, Postman of MCP.

Integratieworkflow

Een eenvoudig pad van de eerste request naar herhaalbaar productiegebruik.

1
Eenmalig authenticeren

Stuur je API-sleutel met de gedocumenteerde header en houd requests consistent tussen services.

2
Query met voorbeelden

Start met de curl- en HTTP-voorbeelden en map daarna de parameters naar je applicatiecode.

3
Opereren en monitoren

Gebruik statuscodes, kredietkosten en responsvelden om retries, logs en alerts te bouwen.

Developerkit

Ga vanaf deze pagina naar machineleesbare docs, requestcollecties, SDKs of agenttools.

Parameter- en responskaart

Bekijk inputs, outputvelden en statuscodes voordat je het endpoint in je client aansluit.

Requestparameters

Parameter

phonedefault_countryexpected_countrydialing_from_countrylanguagephones
Responsvelden

Voorbeeldantwoord

inputnormalized_inputkindvalidpossiblestatusrecommendationvalidation_levelreasonwarningsnumbernumber.e164
Statusdekking

HTTP-statuscodes

200400401402429500502503504

Endpoints

POST /v1/phone/validate
Credits: 1Authenticatie: Authenticatie vereist
phonedefault_countryexpected_countrydialing_from_countrylanguage
POST /v1/phone/validate/bulk
Credits: 1Authenticatie: Authenticatie vereist
phonesdefault_countryexpected_countrydialing_from_countrylanguage

Vertrouwenssignalen voordat je integreert

Transparante documentatie, geauthenticeerde requests en zichtbare betrouwbaarheidsdetails maken DomScan makkelijker te beoordelen voor livegang.

Servicestatus API-artifacts

OpenAPI, Swagger, Postman, CLI, SDK en MCP-links zijn één klik verwijderd.

API-sleutels Beschermde toegang

Geauthenticeerde endpoints gebruiken API-sleutels met duidelijke creditkosten voordat je ze aanroept.

Gratis tegoed Gratis Registreren

Begin met 10.000 maandelijkse credits en upgrade pas wanneer het gebruik groeit.

Actief Voorbeeldverzoek

Start met de curl- en HTTP-voorbeelden en map daarna de parameters naar je applicatiecode.

Belangrijkste functies

Strikte validatie van het nummerplan

Controleer de lengte en cijferpatronen met volledige nummerplanmetadata, niet alleen op basis van de lengte.

Gestandaardiseerde formaten

Ontvang de formaten E.164, internationaal, nationaal en RFC 3966, inclusief herkende extensies.

Mogelijk of geldig

Onderscheid nummers met een aannemelijke lengte van nummerbereiken die door het nummerplan worden herkend.

Nummertype en nummerblokinformatie

Bepaal het nummertype, de nummerplanlocatie, mogelijke tijdzones, de oorspronkelijke provider en ondersteuning voor nummerportabiliteit wanneer de metadata dit bevat.

Landspecifiek bellen en verkorte nummers

Analyseer nationale nummers met een land, genereer een belnotatie voor het land van herkomst en herken regionale verkorte nummers en alarmnummers.

Bulkvalidatie

Valideer maximaal 100 nummers per aanvraag, met een afzonderlijk resultaat voor elke invoer.

Offline bronnen en officiële toewijzingen

Gebruik offline metadata en openbare momentopnamen van toezichthouders op de infrastructuur van DomScan. Overeenkomende resultaten bevatten de bron, licentie, bijwerkdatum en context van de oorspronkelijke toewijzing.

Voorbeeldverzoek

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

Voorbeeldantwoord

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
}

Veelgestelde vragen

Wat betekent een geldig telefoonnummer?

Geldig betekent dat het nummer overeenkomt met de vastgelegde lengte en cijferpatronen van een herkend nummerplanbereik. Het betekent niet dat het nummer aan een abonnee is toegewezen.

Bewijst validatie dat het nummer actief of bereikbaar is?

Nee. Nummerplanvalidatie kan niet bevestigen dat een nummer is toegewezen, actief of bereikbaar is, of oproepen of sms-berichten kan ontvangen.

Geeft de API de huidige provider of eigenaar van de telefoon terug?

De API kan de oorspronkelijke provider van een nummerblok of de houder van een toewijzing door de toezichthouder retourneren. Geen van beide velden vermeldt de huidige provider na nummerportering en geen van beide identificeert de abonnee of eigenaar van het telefoonnummer.

Hebben nationale telefoonnummers een land nodig?

Ja. Geef een standaardland of -regio op als het nummer niet met een internationaal landnummer begint. Er is ook een land nodig om regionale verkorte nummers en alarmnummers te interpreteren.

Waar komen de informatiegegevens vandaan?

Wereldwijde metadata komt van Google libphonenumber. Officieel bewijs voor nummerblokken en voorvoegsels kan ook afkomstig zijn uit openbare momentopnamen van CNMC, ARCEP, Bundesnetzagentur, MIC Japan, RTR Oostenrijk, Nkom, UKE Polen, MODA Taiwan, NANPA voor de Verenigde Staten en CNA/CNAC voor Canada. Amerikaanse en Canadese gegevens beschrijven de status van NPA-NXX-centralecodes en de oorspronkelijke houders van de codes, niet de huidige provider van een geporteerd nummer. Elk resultaat vermeldt de bronnen, momentopnamedatums en het dekkingsniveau. Locatie en tijdzones beschrijven het nummerplanblok, niet de huidige locatie van de telefoon.

Kan ik telefoonnummers in bulk valideren?

Ja. Het bulkendpoint accepteert maximaal 100 nummers en retourneert de resultaten in de volgorde van de invoer. Als offline verrijking niet beschikbaar is, wordt de lokale validatie toch voltooid en vermeldt intelligence.status de terugvalstatus.

Gerelateerde hulpprogramma's en bronnen

HTTP-statuscodes

We documenteren de HTTP-statuscodes die je client moet afhandelen, zodat je succesvolle responses, authenticatieproblemen, credits, ratelimieten, ontbrekende gegevens en upstreamfouten kunt onderscheiden.

OK 200

Aanvraag geslaagd

Ongeldig verzoek 400

Ongeldige parameters

Niet geautoriseerd 401

API-sleutel of sessie ontbreekt of is ongeldig.

Betaling vereist 402

Niet genoeg credits om deze aanvraag uit te voeren.

Te veel verzoeken 429

Snelheidslimiet overschreden

Serverfout 500

Interne fout

Gatewayfout 502

Upstream RDAP-fout

Service niet beschikbaar 503

De upstreamservice is niet beschikbaar of beperkt tijdelijk aanvragen.

Gateway-time-out 504

De upstream-aanvraag heeft de tijdslimiet overschreden.

Probeer telefoonnummerinformatie gratis