Genel API · Ücretsiz Katman

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

Postman Koleksiyonunu Aç Arama aracını dene

Resmi 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

Method	Path	Description
POST	/eu-vat/lookup	Bir ülke + KDV numarasını doğrular. Anonim katmanda maskelenmiş şirket verisi döner.
POST	/eu-vat/verify	Çift onay akışından gelen e-posta token'ını doğrular. Tam maskesiz kaydı açar.
POST	/eu-vat/resend	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.

1 · Postman koleksiyonunu açın

Tek tıkla çalışma alanınıza fork edin. Tüm uç noktalar, örnek gövdeler ve örnek yanıtlar dahildir.

2 · 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.

3 · 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

curl -X POST 'https://atlas.apivom.com/eu-vat/lookup' \
  -H 'Content-Type: application/json' \
  -d '{ "country_code": "IE", "vat_number": "3515583EH" }'

JavaScript

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);

Python

import requests

resp = requests.post(
    'https://atlas.apivom.com/eu-vat/lookup',
    json={'country_code': 'IE', 'vat_number': '3515583EH'},
    timeout=10,
)
print(resp.json())

FAQ

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.

60 saniyede doğrulamaya başlayın

Postman koleksiyonunu forklayın ve ilk isteğinizi gönderin — kayıt yok, kredi kartı yok, API anahtarı gerekmez.

Postman Koleksiyonunu Aç Canlı aracı görün