Ürünlerimiz

erapi

Doğrulama, Türkiye verileri, TCMB döviz ve geliştirici araçları tek API'de.

Hemen dene Teklif al

Öne çıkan özellikler

Doğrulama

TC kimlik numarası, IBAN ve vergi numarası doğrulama uçları.

Türkiye verileri

Uygulamalarınızda kullanacağınız Türkiye'ye özgü veri servisleri.

TCMB döviz

TCMB döviz kurlarını API üzerinden alın.

Geliştirici araçları

UUID, hash, QR kod ve barkod üretimi.

Her uçta aynı yanıt biçimi

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.

Swagger ve canlı deneme

Açık Swagger arayüzü ve her servisin kendi sayfasındaki «Dene» alanıyla uçları kod yazmadan tarayıcıda çağırın.

Tarayıcıdan doğrudan çağrı

API yolları çapraz kaynak (CORS) isteklerine açıktır; ön yüz uygulamanız uçları doğrudan çağırabilir.

Adil kullanım sınırı

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.

Ürün dokümantasyonu

Genel bakış

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.

Yanıt biçimi

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.

Doğrulama uçları

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.

Türkiye verileri

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.

TCMB döviz kurları ve çevirme

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.

Geliştirici araçları

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

Hata kodları ve sınırlar

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

Deneme ve izleme

  • Katalog: ana sayfa ve servis listesi; her servisin kendi sayfasında Dene alanı bulunur.
  • Swagger: /swagger adresinde tüm uçların açık belgesi ve çağrı arayüzü.
  • Sağlık ucu: /healthz durum ve sürüm bilgisi döner; izleme araçlarına bağlanabilir.
  • Arayüz Türkçe ve İngilizcedir.

3 adımda kurulum

  1. 1. Kataloğu gezin

    Servisleri dört kategoride (Doğrulama, Araçlar, Finans, Türkiye) inceleyin; her servisin sayfasında parametreler ve örnek yanıt yer alır.

  2. 2. Tarayıcıda deneyin

    Servis sayfasındaki «Dene» alanından ya da Swagger arayüzünden uca gerçek bir istek gönderin.

  3. 3. Uygulamanıza bağlayın

    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.

Sık sorulan sorular

erapi'yi denemek için ne gerekir?

erapi.erp.tr üzerinden servisleri inceleyebilir, kurumsal kullanım için teklif isteyebilirsiniz.

TC Kimlik veya IBAN doğrulaması resmi kayıt sorgular mı?

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.

Döviz kurları nereden geliyor?

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.

Kota aşılırsa ne olur?

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.

API'yi tarayıcıdaki ön yüzümden çağırabilir miyim?

Evet. API yolları çapraz kaynak (CORS) isteklerine açıktır; ön yüz uygulamanız uçları doğrudan çağırabilir.

Nasıl deneyebilirim?

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.

Teklif al