temsor API
← Doğrulama

AB KDV Numarası Doğrulama

AB KDV numarasını resmî VIES kaydına karşı doğrular; ülke bazlı biçim denetimi yapar ve servis kesintilerini dürüstçe raporlar.

POST /v1/eu/vat/validate · 2 kredi

  • Bu sayfadaki her ucu hesap açmadan deneyebilirsiniz.
  • Deterministik uçlar önbellekten tek haneli milisaniyede yanıtlar.
  • Her yanıt bir fiş taşır: harcanan kredi, önbellek durumu, süre.
Bir ucu dene Şemayı oku
POST/v1/eu/vat/validate 
{
  "vatNumber": "DE811907980"
}
henüz istek gönderilmedi
Çalıştır’a basınca tarayıcınızdan canlı API çağrılır.
1uç nokta
—biriken veri noktası
—zaman serisi
—ortanca yanıt

Neden var

Düşman girdi için tasarlandı

Türkçe adres "Cd." de olur "Cad." da "Caddesi" de; daire numarası bina numarasına yapışık gelir. Genel ayrıştırıcılar yarısını sessizce düşürür. Bu, yerleştiremediğini size söyler.

Tarihçe sonradan üretilemez

Kur arşivi her iş günü büyüyor ve her nokta kaynak URL’i ile içerik özetini saklıyor. Rakip bugünün bültenini okuyabilir — geçen çeyreği üretemez.

Yalnız yapılan işe ödersiniz

Tekrarlanan girdi önbellekten gelir, sıfır kredi yakar. Bir yanıt kendi şemasına uymazsa çağrı otomatik iade edilir.

Uç noktalarparametreleri görmek ve canlı çağırmak için satırı açın

Doğrulama1

/v1/eu/vat/validate AB KDV Numarası Doğrulama 2 kredi

AB KDV numarasını resmî VIES kaydına karşı doğrular; ülke bazlı biçim denetimi yapar ve servis kesintilerini dürüstçe raporlar.

VIES ücretsizdir ama güvenilmezdir: üye devlet servisleri tek tek düşer ve başarısız bir sorgu kolayca ret gibi okunur. Kesintiyi "geçersiz" saymak, muaf olması gereken müşteriye KDV eklemek demektir — bedeli parayla ölçülen bir hata. Bu yüzden servis cevap veremediğinde ASLA `invalid` dönülmez; `unknown` dönülür, sebebi yazılır ve o ülkenin servisinin şu an ayakta olup olmadığı bildirilir. Biçim önce yerel denetlenir, böylece bariz yazım hatası yukarı akışa çağrı olmaz. Sonuçlar 24 saat önbelleklenir. Üye devletlerin çoğu firma adını paylaşmaz; paylaşanlarda ad ve adres döner.

Parametreler

vatNumber* string VAT number with or without the country prefix, e.g. "DE811907980".
countryCode string Country code, when the number is given without a prefix.
POST/v1/eu/vat/validate 
{
  "vatNumber": "DE811907980"
}
henüz istek gönderilmedi
Çalıştır’a basınca tarayıcınızdan canlı API çağrılır.

Fiyatlandırmatek anahtar tüm uçları kapsar

Free
Ücretsiz
kredi
2,000
Hız sınırı
2/s
Hemen dene
Starter
$19/ay
kredi
50,000
Hız sınırı
10/s
en çok seçilen
Pro
$79/ay
kredi
300,000
Hız sınırı
30/s
Scale
$299/ay
kredi
2,000,000
Hız sınırı
100/s

Kredi çağrı başına düşer, önbellekten gelen yanıt ücretsizdir. Anahtarsız istekler IP başına dar bir demo kotasıyla çalışır; kaydolmadan değerlendirebilirsiniz.

API anahtarı ödeme onaylanır onaylanmaz e-postayla gelir. Plan yükseltmede anahtar DEĞİŞMEZ, entegrasyonunuz kırılmaz.

Yapay zekâ asistanından kullanaynı katalog, MCP aracı olarak

Her uç aynı zamanda Model Context Protocol üzerinden yayınlanıyor; Claude, ChatGPT ya da kendi ajanınız doğrudan çağırabilir — ara kod yok, sarmalayıcı fonksiyon yok. Asistan aynı girdi şemalarını ve aynı ölçümü görür.

Şu an 12 araç. Yeni uçlar kendiliğinden görünür; sizin tarafınızda güncellenecek bir şey yok.

claude_desktop_config.json

{
  "mcpServers": {
    "temsor": {
      "url": "https://api.temsor.com/mcp",
      "headers": { "x-api-key": "fk_live_…" }
    }
  }
}

Hızlı başlangıç

Resmî istemci: npm install temsor-api · npmjs.com/package/temsor-api

Node.js

import Client from "temsor-api";

const api = new Client({ apiKey: KEY });
const r = await api.${(() => {
  const first = apis[0];
  return first.slug.split(/[/-]/).map((p, i) => (i === 0 ? p : p[0].toUpperCase() + p.slice(1))).join('');
})()}(${esc(JSON.stringify(apis[0].examples[0]?.input ?? {}))});
console.log(r, r.$meta);

cURL

curl -s https://api.temsor.com/v1/eu/vat/validate \
  -H "content-type: application/json" \
  -H "x-api-key: fk_live_…" \
  -d '{"vatNumber":"DE811907980"}'

JavaScript

const res = await fetch("https://api.temsor.com/v1/eu/vat/validate", {
  method: "POST",
  headers: { "content-type": "application/json", "x-api-key": KEY },
  body: JSON.stringify({"vatNumber":"DE811907980"})
});
const { data } = await res.json();

Python

import httpx
r = httpx.post("https://api.temsor.com/v1/eu/vat/validate",
    headers={"x-api-key": KEY},
    json={"vatNumber":"DE811907980"})
data = r.json()["data"]