Entegrasyondan önce canlı hizmet durumunu ve belgelenmiş hata yanıtlarını kontrol edin.
Harika şirketlerdeki insanlar tarafından kullanılıyor
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.
OpenAPI, Swagger, Postman, CLI, SDK ve MCP bağlantıları bir tık uzakta.
Kimliği doğrulanmış endpointler, çağrıdan önce net kredi maliyetleriyle API anahtarları kullanır.
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ı.
Domain kontrollerini, DNS istihbaratını, risk sinyallerini veya zenginleştirmeyi onboarding, arama ve dahili araçlara gömün.
Tekrarlanan manuel sorguları planlı işler, uyarılar ve yeniden üretilebilir araştırma adımlarıyla değiştirin.
Sağlayıcı sayfalarını kazımak yerine öngörülebilir alanlar, belgelenmiş durum kodları ve kredi maliyetleri kullanın.
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.
API anahtarınızı belgelenmiş header ile gönderin ve servisler arasında istekleri tutarlı tutun.
curl ve HTTP örneklerinden başlayın, sonra parametreleri uygulama kodunuza eşleyin.
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.
Client üretin veya her istek ve yanıt şeklini inceleyin.
Postman koleksiyonuManuel test ve ekip devri için hazır istekleri içe aktarın.
SDK’ler ve CLIBoilerplate yazmak yerine bakımı yapılan paketleri ve komut satırı workflow’larını kullanın.
MCP entegrasyonuDomain intelligence’ı AI agent’larına ve dahili asistan workflow’larına açın.
Parametre ve yanıt haritası
Endpoint’i client’ınıza bağlamadan önce girdileri, çıktı alanlarını ve durum kodlarını tarayın.
Parametre
Örnek Yanıt
HTTP Durum Kodları
Uç Noktalar
/v1/phone/validate
/v1/phone/validate/bulk
Ö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.
Hangi kayıtların canlı ağ sorgusunu hak ettiğine karar vermeden önce her numarada rutin numaralandırma planı kontrolleri çalıştırın.
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.
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.
OpenAPI, Swagger, Postman, CLI, SDK ve MCP bağlantıları bir tık uzakta.
Kimliği doğrulanmış endpointler, çağrıdan önce net kredi maliyetleriyle API anahtarları kullanır.
Aylık 10.000 krediyle başlayın ve yalnızca kullanım arttığında yükseltin.
curl ve HTTP örneklerinden başlayın, sonra parametreleri uygulama kodunuza eşleyin.
Temel Özellikler
Yalnızca uzunluğa değil, tam numaralandırma planı meta verilerine göre uzunluğu ve rakam örüntülerini kontrol edin.
Ayrıştırılmış uzantılar dahil E.164, uluslararası, ulusal ve RFC 3966 biçimlerini döndürün.
Akla yatkın uzunluğa sahip numaraları, numaralandırma planı tarafından tanınan aralıklardan ayırın.
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.
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.
Her girdi için ayrı bir sonuçla istek başına 100'e kadar numarayı doğrulayın.
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
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
{
"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, 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.
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, ö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.
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.
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.
İstek başarılı
Geçersiz parametreler
API anahtarı veya oturum eksik ya da geçersiz.
Bu isteği çalıştırmak için yeterli krediniz yok.
Hız sınırı aşıldı
Dahili hata
Telefon Numarası İstihbaratını Ücretsiz Deneyin