Kimlik ve Doğrulama 2 Uç Noktalar 7 Temel Özellikler

Telefon Numarası İstihbaratı API'si

Ulusal veya uluslararası telefon numaralarını doğrulayın, biçimlerini normalleştirin ve yararlı çevrimdışı bağlam ekleyin. Sonuçlar, ücretli telekomünikasyon sorgusu olmadan numaralandırma planı konumunu, olası saat dilimlerini, özgün önek operatörünü, arama yönlendirmesini, kısa kod sinyallerini ve eşleşen herkese açık düzenleyici tahsislerini içerebilir.

Kategori Kimlik ve Doğrulama
Uç Noktalar 2
Temel Özellikler 7
Sıkça Sorulan Sorular 5

Harika şirketlerdeki insanlar tarafından kullanılıyor

VercelLLM PulseOLXCasa ModernaPipeCal.comBeehiivSnykTogglRemoteSprigDeel

Entegrasyondan önce güven sinyalleri

Şeffaf dokümanlar, kimliği doğrulanmış istekler ve görünür güvenilirlik ayrıntıları, yayına almadan önce DomScan’i değerlendirmeyi kolaylaştırır.

Canlı Hizmet durumu

Entegrasyondan önce canlı hizmet durumunu ve belgelenmiş hata yanıtlarını kontrol edin.

OpenAPI API materyalleri

OpenAPI, Swagger, Postman, CLI, SDK ve MCP bağlantıları bir tık uzakta.

API anahtarları Korumalı erişim

Kimliği doğrulanmış endpointler, çağrıdan önce net kredi maliyetleriyle API anahtarları kullanır.

10,000 Ücretsiz hak

Aylık 10.000 krediyle başlayın ve yalnızca kullanım arttığında yükseltin.

Bu API neyi yayına almanıza yardımcı olur

Bu sayfayı üretim özeti olarak kullanın: endpointler, örnekler, yanıt yapısı ve DomScan’i ürününüze bağlamak için gereken workflow parçaları.

Ürün workflow’ları

Domain kontrollerini, DNS istihbaratını, risk sinyallerini veya zenginleştirmeyi onboarding, arama ve dahili araçlara gömün.

Analist otomasyonu

Tekrarlanan manuel sorguları planlı işler, uyarılar ve yeniden üretilebilir araştırma adımlarıyla değiştirin.

Temiz JSON verisi

Sağlayıcı sayfalarını kazımak yerine öngörülebilir alanlar, belgelenmiş durum kodları ve kredi maliyetleri kullanın.

AI ve ops araçları

OpenAPI, SDK, Postman veya MCP üzerinden agent’ları, panoları, SOAR playbook’larını ve CRM’leri besleyin.

Entegrasyon workflow’u

İlk istekten tekrarlanabilir üretim kullanımına giden basit yol.

1
Bir kez doğrulayın

API anahtarınızı belgelenmiş header ile gönderin ve servisler arasında istekleri tutarlı tutun.

2
Örneklerle sorgulayın

curl ve HTTP örneklerinden başlayın, sonra parametreleri uygulama kodunuza eşleyin.

3
İşletin ve izleyin

Retry, log ve uyarılar için durum kodlarını, kredi maliyetlerini ve yanıt alanlarını kullanın.

Geliştirici kiti

Bu sayfadan makine tarafından okunabilir dokümanlara, istek koleksiyonlarına, SDK’lere veya agent araçlarına geçin.

Parametre ve yanıt haritası

Endpoint’i client’ınıza bağlamadan önce girdileri, çıktı alanlarını ve durum kodlarını tarayın.

İstek parametreleri

Parametre

phonedefault_countryexpected_countrydialing_from_countrylanguagephones
Yanıt alanları

Örnek Yanıt

inputnormalized_inputkindvalidpossiblestatusrecommendationvalidation_levelreasonwarningsnumbernumber.e164
Durum kapsamı

HTTP Durum Kodları

200400401402429500

Uç Noktalar

POST /v1/phone/validate
Kredi: 1Kimlik Doğrulama: Kimlik dogrulama gerekli
phonedefault_countryexpected_countrydialing_from_countrylanguage
POST /v1/phone/validate/bulk
Kredi: 1/itemKimlik Doğrulama: Kimlik dogrulama gerekli
phonesdefault_countryexpected_countrydialing_from_countrylanguage

Önce doğrulayın. Canlı telekomünikasyon verileri için yalnızca gerektiğinde ödeme yapın.

DomScan ilk geçişi numaralandırma planı doğrulaması, standart biçimler, çevrimdışı meta veriler ve kullanılabildiğinde resmî aralık veya önek kanıtlarıyla gerçekleştirir. Önce numaraları filtreleyip yönlendirin, ardından yalnızca bir karar güncel operatör veya taşıma verilerine, erişilebilirliğe, yetkili kimlik doğrulamaya ya da sağlayıcıya özgü sahtekârlık sinyallerine bağlıysa ayrı bir canlı hizmet ekleyin.

Numara başına bir kredi

Hangi kayıtların canlı ağ sorgusunu hak ettiğine karar vermeden önce her numarada rutin numaralandırma planı kontrolleri çalıştırın.

Numara başına telekomünikasyon sorgusu yok

DomScan biçimi, belgelenen aralıkları ve çevrimdışı meta verileri kontrol eder. Konum bir numaralandırma planı alanıdır, fiziksel konum değildir. Operatör veya tahsis sahibi özgün aralık ilişkisidir, numara taşındıktan sonra mevcut operatör olması gerekmez. Sonuç tahsisi, etkinliği, erişilebilirliği, SMS teslimini veya abone kimliğini doğrulamaz.

Resmî tahsis bağlamı

Kapsam mevcut olduğunda eşleşen aralık durumunu ve özgün tahsis sahibini kaynak ve anlık görüntü ayrıntılarıyla görün. Bu bilgi bir aralığı açıklar, mevcut operatörü veya aboneyi tanımlamaz.

Entegrasyondan önce güven sinyalleri

Şeffaf dokümanlar, kimliği doğrulanmış istekler ve görünür güvenilirlik ayrıntıları, yayına almadan önce DomScan’i değerlendirmeyi kolaylaştırır.

Hizmet durumu API materyalleri

OpenAPI, Swagger, Postman, CLI, SDK ve MCP bağlantıları bir tık uzakta.

API anahtarları Korumalı erişim

Kimliği doğrulanmış endpointler, çağrıdan önce net kredi maliyetleriyle API anahtarları kullanır.

Ücretsiz hak Ücretsiz Kaydol

Aylık 10.000 krediyle başlayın ve yalnızca kullanım arttığında yükseltin.

Aktif Örnek İstek

curl ve HTTP örneklerinden başlayın, sonra parametreleri uygulama kodunuza eşleyin.

Temel Özellikler

Titiz numaralandırma planı doğrulaması

Yalnızca uzunluğa değil, tam numaralandırma planı meta verilerine göre uzunluğu ve rakam örüntülerini kontrol edin.

Standartlaştırılmış biçimler

Ayrıştırılmış uzantılar dahil E.164, uluslararası, ulusal ve RFC 3966 biçimlerini döndürün.

Olası ve geçerli ayrımı

Akla yatkın uzunluğa sahip numaraları, numaralandırma planı tarafından tanınan aralıklardan ayırın.

Numara türü ve önek istihbaratı

Meta veriler içerdiğinde numara türünü, numaralandırma planı konumunu, olası saat dilimlerini, özgün önek operatörünü ve taşınabilirlik desteğini belirleyin.

Ülke farkındalıklı arama ve kısa kodlar

Ulusal numaraları bir ülkeyle ayrıştırın, kaynağa özgü arama biçimleri oluşturun ve bölgesel kısa kodlarla acil durum numaralarını tanıyın.

Toplu doğrulama

Her girdi için ayrı bir sonuçla istek başına 100'e kadar numarayı doğrulayın.

Çevrimdışı kaynaklar ve resmî tahsisler

Kapsam mevcut olduğunda eşleşen aralık durumunu ve özgün tahsis sahibini kaynak ve anlık görüntü ayrıntılarıyla görün. Bu bilgi bir aralığı açıklar, mevcut operatörü veya aboneyi tanımlamaz.

Örnek İstek

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

Örnek Yanıt

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
}

Sıkça Sorulan Sorular

Geçerli bir telefon numarası ne anlama gelir?

Geçerli, numaranın tanınan bir numaralandırma planı aralığının belgelenen uzunluk ve rakam örüntüleriyle eşleştiği anlamına gelir. Numaranın bir aboneye tahsis edildiği anlamına gelmez.

Doğrulama numaranın etkin veya erişilebilir olduğunu kanıtlar mı?

Hayır. Numaralandırma planı doğrulaması bir numaranın tahsis edildiğini, etkin olduğunu, erişilebilir olduğunu veya çağrı ya da SMS alabildiğini doğrulayamaz.

API mevcut operatörü veya telefon sahibini döndürür mü?

API, özgün bir önek operatörünü veya düzenleyici tahsis sahibini döndürebilir. Numara taşındıktan sonra bu alanların hiçbiri mevcut operatör değildir ve aboneyi ya da telefon sahibini tanımlamaz.

Ulusal telefon numaraları ülke gerektirir mi?

Evet. Numara uluslararası arama koduyla başlamıyorsa varsayılan ülke veya bölge sağlayın. Bölgesel kısa kodları ve acil durum numaralarını yorumlamak için de ülke gereklidir.

Telefon numaralarını toplu olarak doğrulayabilir miyim?

Evet. Toplu uç nokta en fazla 100 numarayı kabul eder ve sonuçları girdi sırasıyla döndürür. Çevrimdışı zenginleştirme kullanılamadığında yerel doğrulama yine tamamlanır ve intelligence.status geri dönüşü bildirir.

İlgili Araçlar ve Kaynaklar

HTTP Durum Kodları

Başarılı yanıtları, kimlik doğrulama sorunlarını, kredileri, hız sınırlarını, eksik verileri ve yukarı akış hatalarını ayırt edebilmeniz için istemcinizin işlemesi gereken HTTP durum kodlarını belgeliyoruz.

OK 200

İstek başarılı

Hatalı İstek 400

Geçersiz parametreler

Yetkisiz 401

API anahtarı veya oturum eksik ya da geçersiz.

Ödeme Gerekli 402

Bu isteği çalıştırmak için yeterli krediniz yok.

Çok Fazla İstek 429

Hız sınırı aşıldı

Sunucu Hatası 500

Dahili hata

Telefon Numarası İstihbaratını Ücretsiz Deneyin