AB KDV Doğrulama API
Resmi AB VIES servisinin üzerine yazılmış, üretim için hazır ücretsiz REST sarmalayıcı. Tek HTTP çağrısıyla herhangi bir AB KDV numarasını doğrulayın — JSON yanıtlar, edge önbellek, makul hız sınırları ve KVKK/GDPR uyumlu denetim kayıtları.
Genel API · ücretsiz katmanResmi VIES kaynağı
ec.europa.eu/taxation_customs/vies tarafından desteklenir — AB'nin yetkili kaydı. 24 saatlik şeffaf edge önbelleği gecikmeyi azaltır.
SOAP değil JSON
VIES SOAP sunar; biz temiz REST + JSON ile sararız, böylece WSDL ile uğraşmak yerine dakikalar içinde entegre edebilirsiniz.
Hız sınırlı & anonim
Anonim katman: 3 sorgu/IP/gün. E-postanızı doğrulayın → 5 doğrulama/IP/gün. Daha yüksek katmanlar partnerler için mevcuttur.
KVKK/GDPR uyumlu
IP adresleri kayıttan önce SHA-256 ile hashlenir. Anonim akışta kalıcı kişisel veri yoktur.
Sahada kanıtlanmış
Üretimdeki müşteriye dönük /tools/eu-business-lookup aracını besler. Aynı kod yolu, aynı çalışma süresi garantileri.
Deneme için kayıt gerekmez
Değerlendirmek için doğrudan genel uç noktayı kullanın. Daha yüksek limit veya webhook için partner katmanı için bizimle iletişime geçin.
Uç noktalar
Tüm uç noktalar JSON kabul eder ve JSON döner. Hatalar RFC 7807 (problem+json) standardına uyar.
Temel URL: https://atlas.apivom.com
Bir ülke + KDV numarasını doğrular. Anonim katmanda maskelenmiş şirket verisi döner.
Çift onay akışından gelen e-posta token'ını doğrular. Tam maskesiz kaydı açar.
Kullanıcı e-postayı kaybederse onay e-postasını yeniden gönderir. Aynı günlük IP limitine tabidir.
Hızlı başlangıç
Sıfırdan ilk doğrulanmış KDV numaranıza üç adım.
Uç nokta listesini inceleyin
Tüm uç noktalar yöntem ve yollarıyla yukarıda listelenir. Aşağıdaki curl örneği eksiksiz bir isteği gösterir.
Bir lookup isteği gönderin
/eu-vat/lookup uç noktasına country_code + vat_number POST edin. Anında maskeli sonuç + lookup ID alın.
Maskeyi kaldırmak için e-postayı doğrulayın
İsteğe bağlı çift onay: kullanıcı e-postasını yakalayın, onay gönderin, sonra token ile /eu-vat/verify çağırın — tam şirket verisi açılır.
curl -X POST 'https://atlas.apivom.com/eu-vat/lookup' \
-H 'Content-Type: application/json' \
-d '{ "country_code": "IE", "vat_number": "3515583EH" }'const res = await fetch('https://atlas.apivom.com/eu-vat/lookup', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({ country_code: 'IE', vat_number: '3515583EH' }),
});
const data = await res.json();
console.log(data);import requests
resp = requests.post(
'https://atlas.apivom.com/eu-vat/lookup',
json={'country_code': 'IE', 'vat_number': '3515583EH'},
timeout=10,
)
print(resp.json())Sıkça sorulan sorular.
Bu gerçekten ücretsiz mi?
Evet — anonim katman günlük kullanım için ücretsizdir (IP başına günde 3 sorgu). Yüksek hacimler için talep üzerine API anahtarlı partner uç noktaları mevcuttur.
Veriler ne kadar günceldir?
VIES gerçek zamanlı sorgulanır; başarılı yanıtlar hem uygulamanızı hem de yukarı yöndeki servisi korumak için edge'de 24 saat önbelleğe alınır.
Kontrol ettiğim KDV numaralarını saklıyor musunuz?
Doğrulanan sorguları (ülke kodu, KDV no, geçerlilik, zaman damgası) denetim amaçlı saklarız. IP'ler kayıttan önce hashlenir. Anonim çağrılar için kişisel veri saklamayız.
Şirket adı neden maskeli?
Kayıt otomasyonlu sıyırma (scraping) saldırılarını önlemek için anonim yanıtlarda ad ve adres kısmen maskelenir. Tam kaydı almak için e-postanızı doğrulayın.
VIES çalışmazsa ne olur?
Açık bir hata ile 503 alırsınız. Yukarı yöndeki servise ulaşılamadığında veri uydurmayız.
Partner anahtarı alabilir miyim?
Evet. İletişim sayfasından bize ulaşın ve beklenen hacim + entegrasyon kullanım senaryonuzu paylaşın.