API für Telefonnummern-Intelligenz und -Validierung

Kategorie Sicherheit

Endpunkte 2

Hauptfunktionen 7

Häufig gestellte Fragen 6

Vertrauenssignale vor der Integration

Transparente Dokumentation, authentifizierte Anfragen und sichtbare Zuverlässigkeitsdetails erleichtern die Bewertung von DomScan vor dem Launch.

Live Dienststatus

Prüfen Sie vor der Integration den aktuellen Dienstzustand und die dokumentierten Fehlerantworten.

OpenAPI API-Artefakte

OpenAPI, Swagger, Postman, CLI, SDK und MCP-Links sind nur einen Klick entfernt.

API-Schlüssel Geschützter Zugriff

Authentifizierte Endpunkte nutzen API-Schlüssel mit klaren Credit-Kosten vor dem Aufruf.

10,000 Kostenloses Kontingent

Starte mit 10.000 monatlichen Credits und upgrade erst, wenn die Nutzung wächst.

Wobei diese API beim Bauen hilft

Nutze diese Seite als Produktionsbriefing: Endpoints, Beispiele, Antwortstruktur und Workflow-Bausteine, um DomScan in dein Produkt einzubinden.

Produkt-Workflows

Bette Domainchecks, DNS-Intelligence, Risikosignale oder Anreicherung in Onboarding, Suche und interne Tools ein.

Analysten-Automatisierung

Ersetze wiederholte manuelle Lookups durch geplante Jobs, Alerts und reproduzierbare Untersuchungsschritte.

Saubere JSON-Daten

Nutze vorhersehbare Felder, dokumentierte Statuscodes und Credit-Kosten statt Provider-Seiten zu scrapen.

KI- und Ops-Tools

Versorge Agenten, Dashboards, SOAR-Playbooks und CRMs über OpenAPI, SDK, Postman oder MCP.

Integrationsablauf

Ein einfacher Weg von der ersten Anfrage bis zur wiederholbaren Nutzung in Produktion.

Einmal authentifizieren

Sende deinen API-Schlüssel mit dem dokumentierten Header und halte Anfragen über Services hinweg konsistent.

Mit Beispielen abfragen

Starte mit den curl- und HTTP-Beispielen und übertrage die Parameter dann in deinen Anwendungscode.

Betreiben und überwachen

Nutze Statuscodes, Credit-Kosten und Antwortfelder, um Retries, Logs und Alerts zu bauen.

Developer-Kit

Wechsle von dieser Seite zu maschinenlesbaren Docs, Request-Sammlungen, SDKs oder Agenten-Tools.

OpenAPI-Schema

Generiere Clients oder prüfe jede Request- und Response-Struktur.

Postman-Collection

Importiere fertige Requests für manuelle Tests und Team-Handoff.

SDKs und CLI

Nutze gepflegte Pakete und Kommandozeilen-Workflows statt Boilerplate zu schreiben.

MCP-Integration

Stelle Domain-Intelligence für KI-Agenten und interne Assistenten bereit.

Parameter- und Antwortkarte

Prüfe Eingaben, Ausgabefelder und Statuscodes, bevor du den Endpoint in deinen Client einbindest.

Request-Parameter

Parameter

phonedefault_countryexpected_countrydialing_from_countrylanguagephones

Antwortfelder

Beispielantwort

inputnormalized_inputkindvalidpossiblestatusrecommendationvalidation_levelreasonwarningsnumbernumber.e164

Statusabdeckung

HTTP-Statuscodes

200400401402429500502503504

Endpunkte

POST /v1/phone/validate

Credits: 1Authentifizierung: Authentifizierung erforderlich

phonedefault_countryexpected_countrydialing_from_countrylanguage

POST /v1/phone/validate/bulk

Credits: 1Authentifizierung: Authentifizierung erforderlich

phonesdefault_countryexpected_countrydialing_from_countrylanguage

Vertrauenssignale vor der Integration

Transparente Dokumentation, authentifizierte Anfragen und sichtbare Zuverlässigkeitsdetails erleichtern die Bewertung von DomScan vor dem Launch.

Dienststatus API-Artefakte

OpenAPI, Swagger, Postman, CLI, SDK und MCP-Links sind nur einen Klick entfernt.

API-Schlüssel Geschützter Zugriff

Authentifizierte Endpunkte nutzen API-Schlüssel mit klaren Credit-Kosten vor dem Aufruf.

Kostenloses Kontingent Kostenlos Anmelden

Starte mit 10.000 monatlichen Credits und upgrade erst, wenn die Nutzung wächst.

Aktiv Beispielanfrage

Starte mit den curl- und HTTP-Beispielen und übertrage die Parameter dann in deinen Anwendungscode.

Hauptfunktionen

Strenge Nummerierungsplan-Validierung

Länge und Ziffernmuster anhand vollständiger Nummerierungsplan-Metadaten prüfen, nicht nur die Länge.

Standardisierte Formate

E.164-, internationale, nationale und RFC-3966-Formate einschließlich erkannter Durchwahlen ausgeben.

Möglich oder gültig

Nummern mit plausibler Länge von Bereichen unterscheiden, die der Nummerierungsplan erkennt.

Nummerntyp und Präfixinformationen

Nummerntyp, Standort im Nummerierungsplan, mögliche Zeitzonen, ursprünglichen Anbieter des Rufnummernblocks und Unterstützung für Rufnummernmitnahme erkennen, sofern die Metadaten dies ermöglichen.

Länderspezifische Anwahl und Kurzwahlnummern

Nationale Nummern mit Länderangabe parsen, Anwahlformate für das Ursprungsland erzeugen und regionale Kurzwahl- und Notrufnummern erkennen.

Massenvalidierung

Bis zu 100 Nummern pro Anfrage mit einem eigenen Ergebnis für jede Eingabe validieren.

Offline-Quellen und amtliche Zuteilungen

Offline-Metadaten und öffentliche Datenbestände von Regulierungsbehörden in der DomScan-Infrastruktur verwenden. Passende Ergebnisse enthalten Quelle, Lizenz, Aktualisierungsdatum und Kontext zur ursprünglichen Zuteilung.

Beispielanfrage

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

Beispielantwort

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
}

Häufig gestellte Fragen

Was bedeutet eine gültige Telefonnummer?

Gültig bedeutet, dass die Nummer der dokumentierten Länge und den Ziffernmustern eines anerkannten Nummerierungsplanbereichs entspricht. Es bedeutet nicht, dass die Nummer einem Teilnehmer zugewiesen ist.

Beweist die Validierung, dass die Nummer aktiv oder erreichbar ist?

Nein. Die Nummerierungsplan-Validierung kann nicht bestätigen, dass eine Nummer zugewiesen, aktiv, erreichbar oder für Anrufe oder SMS empfangsbereit ist.

Gibt die API den aktuellen Anbieter oder Inhaber der Telefonnummer aus?

Die API kann den ursprünglichen Anbieter des Rufnummernblocks oder dessen behördlichen Zuteilungsnehmer ausgeben. Keines der Felder nennt nach einer Rufnummernmitnahme den aktuellen Anbieter oder identifiziert den Teilnehmer beziehungsweise Inhaber der Telefonnummer.

Benötigen nationale Telefonnummern ein Land?

Ja. Geben Sie ein Standardland oder eine Standardregion an, wenn die Nummer nicht mit einer internationalen Vorwahl beginnt. Ein Land ist auch erforderlich, um regionale Kurzwahl- und Notrufnummern auszuwerten.

Woher stammen die Intelligenzdaten?

Die weltweiten Metadaten stammen von Google libphonenumber. Offizielle Nachweise zu Rufnummernbereichen und Präfixen können außerdem aus öffentlichen Datenbeständen von CNMC, ARCEP, Bundesnetzagentur, MIC Japan, RTR Österreich, Nkom, UKE Polen, MODA Taiwan, NANPA für die Vereinigten Staaten und CNA/CNAC für Kanada stammen. Die Datensätze für die USA und Kanada beschreiben den Status der NPA-NXX-Vermittlungsstellenkennungen und deren ursprüngliche Inhaber, nicht den aktuellen Netzbetreiber einer portierten Rufnummer. Jedes Ergebnis nennt seine Quellen, deren Datenstand und den Abdeckungsgrad. Standort und Zeitzonen beschreiben das Präfix im Nummerierungsplan, nicht die aktuelle Position des Telefons.

Kann ich Telefonnummern massenweise validieren?

Ja. Der Massenendpunkt akzeptiert bis zu 100 Nummern und gibt die Ergebnisse in der Reihenfolge der Eingabe aus. Ist die Offline-Anreicherung nicht verfügbar, wird die lokale Validierung dennoch abgeschlossen und intelligence.status meldet den Rückfall.

HTTP-Statuscodes

Wir dokumentieren die HTTP-Statuscodes, die Ihr Client behandeln sollte, damit Sie erfolgreiche Antworten, Authentifizierungsprobleme, Credits, Ratenlimits, fehlende Daten und Upstream-Fehler unterscheiden können.

OK 200

Anfrage erfolgreich

Bad Request 400

Ungültige Parameter

Nicht autorisiert 401

API-Schlüssel oder Sitzung fehlt oder ist ungültig.

Zahlung erforderlich 402

Nicht genügend Credits für diese Anfrage.

Too Many Requests 429

Ratenlimit überschritten

Server Error 500

Interner Fehler

Bad Gateway 502

RDAP-Upstream-Fehler

Dienst nicht verfügbar 503

Der Upstream-Dienst ist nicht verfügbar oder drosselt vorübergehend.

Gateway-Zeitüberschreitung 504

Die Upstream-Abfrage hat das Zeitlimit überschritten.

Telefonnummern-Intelligenz kostenlos testen

Vollständige API-Dokumentation ansehen APIs

API für Telefonnummern-Intelligenz

Vertrauenssignale vor der Integration

Wobei diese API beim Bauen hilft

Integrationsablauf

Developer-Kit

Parameter- und Antwortkarte

Endpunkte

Vertrauenssignale vor der Integration

Hauptfunktionen

Beispielanfrage

Beispielantwort

Häufig gestellte Fragen

Verwandte Tools & Ressourcen

HTTP-Statuscodes