TC kimlik numarası, IBAN ve vergi numarası doğrulama uçları.
Uygulamalarınızda kullanacağınız Türkiye'ye özgü veri servisleri.
TCMB döviz kurlarını API üzerinden alın.
UUID, hash, QR kod ve barkod üretimi.
Tüm uçlar aynı JSON zarfını döner: başarı durumu, veri, hata kodu ve ölçüm bilgisi. Tek bir istemci kodu yeter.
Açık Swagger arayüzü ve her servisin kendi sayfasındaki «Dene» alanıyla uçları kod yazmadan tarayıcıda çağırın.
API yolları çapraz kaynak (CORS) isteklerine açıktır; ön yüz uygulamanız uçları doğrudan çağırabilir.
API yollarında IP başına kota uygulanır; aşıldığında açık bir 429 yanıtı döner, arayüz ve belgeler bu sınırdan etkilenmez.
Doğrulama (TC kimlik, IBAN, vergi no), Türkiye verileri, finans (TCMB döviz) ve geliştirici araçları (UUID, hash, QR, barkod) tek API'de.
Not: TC kimlik, IBAN ve vergi numarası doğrulaması algoritmiktir (biçim ve kontrol hanesi). NVİ, GİB ya da banka kayıtlarında resmî sorgu değildir; numaranın gerçekten bir kişiye, hesaba veya mükellefe ait olduğunu kanıtlamaz.
Her uçta aynı JSON zarfı
Tüm uçlar aynı zarfı döner:
success: isteğin başarılı olup olmadığı.data: servisin sonucu.error: başarısızlıkta code ve message alanları.meta: servis adı, işlem süresi (elapsedMs) ve veri kaynağı (source: live, cache ya da offline).Uç yolları /api/v1/<kategori>/<servis> biçimindedir.
POST /api/v1/dogrulama
Gövde: {"value":"..."}
/tckimlik: TC Kimlik No algoritmik doğrulaması./vergino: Vergi No (VKN) algoritmik doğrulaması./iban: TR IBAN doğrulaması; geçerliyse banka ve biçimlenmiş IBAN döner./kredikarti: Luhn doğrulaması; geçerliyse kart türü döner./eposta: biçim kontrolü ve alan adı DNS sorgusu.Geçersiz değerlerde reason alanı nedenini açıklar. Kimlik, vergi no, IBAN ve kart kontrolleri algoritmiktir; bir resmi kayıt sorgusu yapılmaz.
GET /api/v1/turkiye
/iller: 81 ilin listesi; plaka, ad, bölge ve alan kodu ile./plaka?kod=34 ve /il?plaka=34: plakaya göre il./alankodu?kod=312: telefon alan koduna göre il./postakodu?kod=34000: posta kodunun ilk iki hanesi plakaya karşılık gelir./ilceler?plaka=34: ilin ilçeleri.Zorunlu parametre eksikse 400 ve INVALID_REQUEST döner.
GET /api/v1/finans
/doviz: TCMB günlük döviz kurları; ?kod=USD ile tek kur süzülür./cevir?amount=100&from=USD&to=TRY: miktarı TCMB kuru üzerinden çevirir; hesap TRY üzerinden, döviz satış kuruyla yapılır./birim?value=100&from=km&to=mil: uzunluk, ağırlık ve sıcaklık birim çevirisi (çevrimdışı).Kurlar kısa süre önbelleğe alınır; meta.source yanıtın canlı mı önbellekten mi geldiğini söyler. TCMB ulaşılamazsa ve önbellek yoksa 502 ve UPSTREAM_UNAVAILABLE döner.
/api/v1/arac
GET /uuid: bir ile 100 arasında UUID üretir.GET /parola: 4–128 karakter uzunluğunda parola üretir; sembol, rakam ve büyük harf seçilebilir.POST /hash: özet (hash) hesaplar.POST /base64: Base64 kodlar ya da çözer (encode / decode).POST /slug: metinden URL dostu bağlantı adı üretir.POST /qr: QR kodu üretir (en çok 2000 karakter).POST /barkod: barkod üretir (en çok 200 karakter).Geçersiz girdi 400 ve INVALID_REQUEST ile açıklayıcı bir mesaj döndürür.
400 / INVALID_REQUEST: eksik ya da geçersiz parametre.404 / NOT_FOUND: /api altında olmayan uçlar da aynı JSON zarfıyla yanıtlanır, HTML sayfası dönmez.429: IP başına kota (60 saniyede 120 istek) aşıldı.502 / UPSTREAM_UNAVAILABLE: TCMB gibi dış kaynak ulaşılamıyor.Sınır yalnızca API yollarına uygulanır; arayüz, belgeler ve Swagger bu kotadan etkilenmez. API yolları çapraz kaynak isteklerine açıktır.
/swagger adresinde tüm uçların açık belgesi ve çağrı arayüzü./healthz durum ve sürüm bilgisi döner; izleme araçlarına bağlanabilir.Bugün (elle / tabloyla)Her projede doğrulama kodu yeniden yazılır ya da hiç yapılmaz.
erapi ileTC kimlik, IBAN ve vergi numarası doğrulaması hazır uçlardan çağrılır.
Bugün (elle / tabloyla)Kurlar sayfadan kopyalanır ya da her uygulama kendi okuyucusunu yazar.
erapi ileTCMB döviz kurları API üzerinden alınır.
Bugün (elle / tabloyla)Her servis farklı yanıt biçimi döndürür, istemci kodu çoğalır.
erapi ileTüm uçlar aynı JSON zarfını döner; Swagger ve «Dene» alanıyla kod yazmadan denenir.
Fiyat, kullanacağınız modüllere, kullanıcı ve şirket sayısına göre belirlenir. Önce ücretsiz deneyin ya da kısa bir canlı tanıtım isteyin; kapsam netleşince yazılı teklif gönderelim.
Servisleri dört kategoride (Doğrulama, Araçlar, Finans, Türkiye) inceleyin; her servisin sayfasında parametreler ve örnek yanıt yer alır.
Servis sayfasındaki «Dene» alanından ya da Swagger arayüzünden uca gerçek bir istek gönderin.
Aynı isteği kendi kodunuzdan gönderin; yanıt zarfı her uçta aynı olduğundan tek bir istemci sınıfı tüm servisleri karşılar.
erapi.erp.biz.tr üzerinden servisleri inceleyebilir, kurumsal kullanım için teklif isteyebilirsiniz.
Hayır. Kimlik no, vergi no, IBAN ve kredi kartı kontrolleri algoritmiktir; bir resmi kayıt ya da banka sorgusu yapılmaz. Kredi kartı için Luhn kontrolü uygulanır.
TCMB günlük döviz kurlarından. Kurlar kısa süre önbelleğe alınır ve yanıttaki meta.source alanı verinin canlı mı önbellekten mi geldiğini gösterir.
API yollarında IP başına 60 saniyede 120 istek sınırı vardır. Aşıldığında 429 yanıtı döner; arayüz ve belgeler bu sınırdan etkilenmez.
Evet. API yolları çapraz kaynak (CORS) isteklerine açıktır; ön yüz uygulamanız uçları doğrudan çağırabilir.
Katalogdaki her servisin sayfasında Dene alanı vardır; ayrıca /swagger adresindeki arayüzden tüm uçları çağırabilirsiniz. Başka bir sorunuz için teklif formunu doldurun.
erapi ile ilgili yenilikleri e-postayla almak ya da sizi aramamızı istemek için kanalınızı seçin.
erapi için bir özellik mi istiyorsunuz, bir öneriniz ya da karşılaştığınız bir sorun mu var? Yazın; her mesajı ekip olarak okuyor ve yol haritasını buna göre şekillendiriyoruz.