Test verisi API ile sitedeki bütün araçlar tek bir adreste: TC kimlik no, yabancı kimlik no, VKN, IBAN, kart, test kişi üret ya da numara doğrula. Anahtar yok, kayıt yok.
REST · JSON · GET
API adresi
GEThttps://tc-uret.com/api/v1/
Siteye girmeden, kendi kodundan, testlerinden ya da terminalden bu adrese istek gönder; ne istediğini tur parametresiyle söyle. Anahtar ya da kayıt gerekmez. Nasıl kullanılır ↓
Deneme alanı
Gerçek kullanımda test verisi API adresini kendi kodundan çağırırsın. Burada parametreleri seçip oluşan adresi ve API'nin döndüğü yanıtı önceden görebilirsin.
Kurulum, paket yükleme, kayıt ya da anahtar yok. Bu REST API'ye bir GET isteği göndermen yeterli; yanıt JSON olarak gelir. TC kimlik API'si, VKN, IBAN ve test kişi üretimi aynı adresten çalışır.
Adım 1
Adresi al
Bütün işlemler tek adreste. Ne istediğini tur parametresiyle söylersin.
https://tc-uret.com/api/v1/
Adım 2
Parametreleri ekle
Adet, biçim, banka, alanlar gibi seçenekler sorgu parametresi olarak eklenir.
?tur=iban&adet=5&banka=00062
Adım 3
Yanıtı kullan
JSON yanıtta ok başarıyı, veri sonucu, hata sorunu söyler.
Postman ve Insomnia'ya tek adımda aktar, projende hazır bir yardımcı fonksiyon kullan, Playwright ve Cypress testlerinde her koşuda yeni veriyle çalış.
Postman ve Insomnia'ya aktarma
Test verisi API'sini Postman'e eklemek tek adımdır. OpenAPI 3 tanımı https://tc-uret.com/api/v1/openapi.php adresinde. Postman'de Import düğmesine bas, Link sekmesine bu adresi yapıştır; bütün parametreleriyle hazır bir koleksiyon oluşur. Insomnia'da Import from URL, Bruno ve diğer OpenAPI uyumlu araçlarda da aynı adres çalışır.
Projende yardımcı fonksiyon
Aşağıdaki küçük fonksiyonu projene ekleyerek test verisi API'sini tek satırla çağırabilirsin. İstek sınırına takılırsa sunucunun söylediği süre kadar bekleyip tekrar dener, hata durumunda anlaşılır bir hata fırlatır. Node 18 ve üzeri ile bütün modern tarayıcılarda ek paket gerektirmeden çalışır.
test-verisi.js
const API = 'https://tc-uret.com/api/v1/';
// İstek sınırına takılırsa Retry-After kadar bekleyip en fazla 3 kez denerexportasyncfunctiontestVerisi(parametreler) {
const url = API + '?' + new URLSearchParams(parametreler);
for (let deneme = 0; deneme < 3; deneme++) {
const yanit = await fetch(url);
if (yanit.status === 429) {
const bekle = Number(yanit.headers.get('Retry-After') || 1);
awaitnew Promise((r) => setTimeout(r, bekle * 1000));
continue;
}
const govde = await yanit.json();
if (!govde.ok) throw new Error(govde.hata);
return govde.veri;
}
throw new Error('İstek sınırı aşıldı, daha sonra tekrar dene.');
}
// Kullanım: const kisiler = await testVerisi({ tur: 'kisi', adet: 10 });
Playwright ve Cypress testlerinde kullanma
Uçtan uca testlerde her koşuda yeni bir kişiyle kayıt olmak, "bu TC kimlik numarası zaten kayıtlı" gibi hataları ortadan kaldırır. CI hattında test verisi API'sine her koşuda bağlı kalmak istemiyorsan, son örnekteki gibi veriyi bir kez üretip fikstür dosyası olarak projene ekle.
// Bir kez çalıştır, çıkan dosyayı projene ekle: testler API'ye bağımlı kalmaz
import { writeFile } from 'node:fs/promises';
const yanit = await fetch('https://tc-uret.com/api/v1/?tur=kisi&adet=200');
const { veri } = await yanit.json();
await writeFile('tests/fixtures/kisiler.json', JSON.stringify(veri, null, 2));
console.log(veri.length + ' kişi yazıldı');
Test verisi API uç nokta referansı
Bütün işlemler /api/v1/ adresine gönderilen GET istekleridir; örneğin bir TCKN API isteği için tur=tckn yeterlidir. Örnek yanıtlar sayfa açıldığında API'nin kendisinden üretilir.
TC kimlik no üret
tur=tckn
Algoritmaya uygun, benzersiz TC kimlik numaraları. Araç sayfası →
Test verisi API'sinin liste döndüren türleri format ile CSV, düz metin ya da SQL olarak da alınabilir. Varsayılan biçim JSON API yanıtıdır; hatalar her zaman JSON'dur.
200
BaşarılıJSON için { "ok": true, "tur", "adet", "veri" }. format=csv, txt ve sql düz metin döner; doğrudan dosyaya yazılabilir.
400
Hatalı istekEksik ya da geçersiz parametre. hata alanı neyin yanlış olduğunu ve geçerli değerleri söyler.
405
Yöntem desteklenmiyorYalnızca GET (ve CORS için OPTIONS) kabul edilir.
429
İstek sınırı aşıldıDakikada 60 istek. Retry-After başlığı kaç saniye beklemen gerektiğini söyler.
1000
Kayıt sınırıTek istekte en fazla 1.000 kayıt üretilir ya da doğrulanır. Daha fazlası için birkaç istek gönder.
CORS
Tarayıcıdan erişimTest verisi API'si bütün kaynaklara açık. X-RateLimit-Remaining başlığı kalan istek hakkını gösterir.
Örnek hata yanıtı · 400
{
"ok": false,
"hata": "adet 1 ile 1000 arasında bir tam sayı olmalı."
}
Sık sorulan sorular
Uç noktalar, istek sınırı ve entegrasyon hakkında sık gelen sorular.
Test verisi API ücretli mi, anahtar gerekiyor mu?
Hayır. Bu ücretsiz API için kayıt, anahtar ya da token gerekmez; adrese bir GET isteği göndermen yeterli.
İstek sınırı nedir?
IP adresi başına dakikada 60 istek ve tek istekte en fazla 1.000 kayıt. Sınırı aşarsan 429 yanıtı ve kaç saniye beklemen gerektiğini söyleyen Retry-After başlığı döner.
Tarayıcıdan, yani frontend kodundan çağırabilir miyim?
Evet. API CORS başlıklarıyla her kaynaktan gelen GET isteklerine açıktır; fetch ile doğrudan çağırabilirsin.
Gönderdiğim numaralar kaydediliyor mu?
Hayır. Doğrulama için gönderdiğin numaralar ya da üretilen veriler saklanmaz. İstek sınırı için yalnızca IP adresinin özeti (hash) bir dakikalık sayaçta tutulur.
Üretilen veriler gerçek mi?
Numaralar algoritmalara uyar ama rastgeledir; tesadüfen gerçek bir kişiye, şirkete ya da hesaba denk gelebilir. Bunu bilmeyiz ve sorgulamayız. API yalnızca yazılım testi içindir.
Postman ya da Insomnia'ya nasıl eklerim?
Postman'de Import, Link seçip https://tc-uret.com/api/v1/openapi.php adresini yapıştır. Insomnia'da da aynı adresi "Import from URL" ile içe aktarabilirsin.
Test verisi API'sinin çalışma süresi garantisi var mı?
Hayır. Ücretsiz bir hizmettir ve kesintisiz çalışma garantisi verilmez. CI hattında her koşuda API'ye bağımlı kalmak yerine veriyi bir kez üretip test fikstürü olarak projene eklemeni öneririz.
Yeni bir tür ya da alan önerebilir miyim?
Evet, iletişim sayfasından yazabilirsin. Mevcut adresler ve yanıt biçimi v1 sürümünde değişmeden kalır.
Aynı işte lazım olacak diğer araçlar
Vergi numarası, IBAN, test kartı ve sahte kişi verisi: hepsi aynı mantıkla, tarayıcında.