Genel Bakış
Mock User Generator API, yazılım test süreçleri ve veri simülasyonları için yüksek performanslı ve özelleştirilebilir sahte (mock) kullanıcı verisi üreten bir RESTful servistir. İstemcilere JSON formatında, farklı detay seviyelerinde kullanıcı profilleri sunar ve bu verilerin CSV, Excel, ve PDF formatlarında indirilmesine olanak tanır.
Yapılandırma & Kurallar
- Versiyon: v1.0.0
- Temel Endpoint (Base URL): /api/v1/users
- İstek Limitlendirme (Rate Limiting): JSON veri üreten "GET" endpoint'leri için dakikada maksimum 60 istek, dosya indirme endpoint'leri için dakikada maksimum 10 istek ile sınırlandırılmıştır.
- Önbellekleme (Caching): Sık tekrarlanan isteklerin yanıt sürelerini iyileştirmek için uç noktalar in-memory (RAM tabanlı) 60 saniyelik bir önbellek katmanı barındırır.
- CORS Stratejisi: Sistem halka açık yapılandırılmış olup (Allow-Origins: *), güvenlik amacıyla sadece salt okunur (GET) HTTP istek metotlarına izin vermektedir.
Endpoints
Bir kullanıcının kişisel, iletişim, adres ve iş bilgilerini içeren geniş kapsamlı bir profil döner.
'https://api.sonercreative.com/api/v1/users/detailed?count=5&locale=tr' \
-H 'accept: application/json'
{
"status": "success",
"data": {
"totalCount": 10,
"results": [
{
"id": "5f4d8...001",
"name": "..."
}
]
}
}
Test listeleri için sadece temel adı, soyadı ve e-posta bilgilerini barındıran hafif bir profil döner.
'https://api.sonercreative.com/api/v1/users/simple?count=50&locale=en' \
-H 'accept: application/json'
{
"status": "success",
"data": {
"totalCount": 10,
"results": [
{
"id": "5f4d8...001",
"name": "..."
}
]
}
}
Yetkilendirme (Auth) testlerinde kullanılmak üzere username, email ve password bilgilerini içeren profil döner.
'https://api.sonercreative.com/api/v1/users/registration?count=5&locale=tr' \
-H 'accept: application/json'
{
"status": "success",
"data": {
"totalCount": 10,
"results": [
{
"id": "5f4d8...001",
"name": "..."
}
]
}
}
Belirtilen profildeki kullanıcı verilerini istenilen dosya formatında bir Attachment (indirilebilir dosya) olarak döner.
| Name | Description |
|---|---|
| format path / string | "csv", "excel", "pdf" değerlerinden birini alabilir. |
| parameter string | Opsiyonel Sorgu 'profile': "detailed", "simple", "registration" olabilir. Varsayılan "detailed"dır. |
'https://api.sonercreative.com/api/v1/users/download/excel?profile=registration&count=100&locale=tr' \
-H 'accept: application/json'
{
"status": "success",
"data": {
"totalCount": 10,
"results": [
{
"id": "5f4d8...001",
"name": "..."
}
]
}
}
Hata Kodları (Responses)
- 400 Bad Request: Geçersiz format isteği (örneğin dosya indirmede csv, excel, pdf dışı bir değer gönderilmesi).
- 422 Unprocessable Entity: Parametre ihlalleri (örneğin count parametresinin 1'den küçük veya 1000'den büyük gönderilmesi).
- 429 Too Many Requests: Rate Limiter tarafından tanımlı olan dakika başı istek limitinin aşılması durumu.