Kimlik ve Doğrulama

İspanyol DNI, NIE ve NIF doğrulama API'si

İspanyol kimlik ve vergi numaralarını formlarda, kayıt süreçlerinde ve faturalamada doğrulayın. API; DNI'ları, NIE'leri, K, L ve M numaralarını ve şirket NIF'lerini tanır, kontrol karakterini denetler ve tutmadığında beklenen karakteri döndürür.

Dokümantasyonu görüntüle Ücretsiz aracı deneyin Tüm API'leri keşfedin

Uç Noktalar Aktif

GET /v1/national-id/validate

Örnek istek

curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/national-id/validate?id=B58378431"

Örnek yanıt 200 OK

{
  "country": "ES",
  "normalized": "B58378431",
  "valid": true,
  "type": "cif",
  "entity_type": "sociedad_responsabilidad_limitada",
  "checks": { "format": true, "control": true },
  "expected_control": null,
  "errors": []
}

Örnek istek GET /v1/national-id/validate

Temel Özellikler 4

Sık sorulan sorular 4

HTTP durum kodları 200 / 400 / 401 / 402 / 429

Kategori Kimlik ve Doğrulama

Uç Noktalar 1

Temel Özellikler 4

Sık sorulan sorular 4

Bu şirketlerdeki kişiler 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.

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.

Bir kez doğrulayın

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

Örneklerle sorgulayın

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

İş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.

OpenAPI şeması

Client üretin veya her istek ve yanıt şeklini inceleyin.

Postman koleksiyonu

Manuel test ve ekip devri için hazır istekleri içe aktarın.

SDK’ler ve CLI

Boilerplate yazmak yerine bakımı yapılan paketleri ve komut satırı workflow’larını kullanın.

MCP entegrasyonu

Domain 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.

İstek parametreleri

Parametre

idcountry

Yanıt alanları

Örnek yanıt

countrynormalizedvalidtypeentity_typecheckschecks.formatchecks.controlexpected_controlerrors

Durum kapsamı

HTTP durum kodları

200400401402429

Uç Noktalar

GET /v1/national-id/validate

Kredi: 1Kimlik Doğrulama: Kimlik dogrulama gerekli

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.

Temel Özellikler

Tüm İspanyol numara türleri

DNI, NIE, K, L ve M NIF'leri ile şirket NIF'leri (eski adıyla CIF); her biri kendi biçimi ve kontrol kurallarıyla tanınır.

Beklenen kontrol karakteri

Yanlış bir son karakter doğrusuyla birlikte döner, böylece kullanıcınıza düzeltmeyi önerebilirsiniz.

Şirket türü

Şirket NIF'leri kuruluş türünü döndürür ve bu türün bir harfle mi yoksa bir rakamla mı bitmesi gerektiğini zorunlu kılar.

Esnek girdi

Boşluklar, noktalar, tireler, küçük harfler, ES öneki ve baştaki sıfırı olmayan 7 haneli DNI'ların hepsi kabul edilir.

Örnek istek

GET /v1/national-id/validate?id=B58378431 bash

curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/national-id/validate?id=B58378431"

Örnek yanıt

200 OK json

{
  "country": "ES",
  "normalized": "B58378431",
  "valid": true,
  "type": "cif",
  "entity_type": "sociedad_responsabilidad_limitada",
  "checks": { "format": true, "control": true },
  "expected_control": null,
  "errors": []
}

Sık sorulan sorular

Geçerli bir sonuç kişinin veya şirketin var olduğu anlamına gelir mi?

Hayır. Kontrol, numaranın doğru bir kontrol karakteriyle düzgün biçimlendirildiğini kanıtlar. Numaranın verildiğini veya kime ait olduğunu kanıtlamaz.

Bir İspanyol şirketinin KDV mükellefi olarak kayıtlı olduğunu doğrulayabilir miyim?

Evet. NIF'i ES önekiyle, AB KDV sicilinde canlı olarak kontrol eden KDV doğrulama API'sine gönderin.

Herhangi bir veri saklanıyor veya paylaşılıyor mu?

Hayır. Kontrol çevrimdışı çalışır ve numara hiçbir üçüncü tarafa gönderilmez.

Kaç krediye mal olur?

Numara başına bir kredi.

İlgili araçlar ve kaynaklar

HTTP durum kodları

İstemcinizin işlemesi gereken HTTP durum kodları şunlardır; böylece başarılı yanıtları, kimlik doğrulama sorunlarını, kredileri, hız sınırlarını, eksik verileri ve üst kaynak hatalarını birbirinden ayırabilirsiniz.

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ı

DNI doğrulayın

Ücretsiz başlayın Dokümantasyonu görüntüle Ücretsiz aracı deneyin