Arka uç henüz mevcut değilken bir kullanıcı arayüzü oluşturuyorsanız, üzerinde işlemek için verilere ihtiyacınız vardır ve DummyJSON bunu elde etmenin en hızlı yollarından biridir. Gerçekçi ürünler, kullanıcılar, sepetler ve daha fazlasını düz HTTP üzerinden sunan, kayıt gerektirmeyen ücretsiz, barındırılan sahte bir REST API'dir. Bu kılavuz, DummyJSON'ın size neler sunduğunu, diğer genel test API'leriyle nasıl karşılaştırıldığını ve sabit yer tutucu verilerin yeterli gelmemesi durumunda ne yapmanız gerektiğini açıklar.
DummyJSON Nedir?
DummyJSON, ücretsiz bir yer tutucu JSON API'sidir. Genel bir uç noktaya istek gönderirsiniz ve bu, yapılandırılmış, inandırıcı örnek veriler döndürür. Kurulacak bir veritabanı veya kaydedilecek bir anahtar yoktur. Ön uç geliştiricileri, öğrenciler ve prototip oluşturan herkesin kodlarında dizileri sabit kodlamak yerine gerçek bir ağ uç noktasına istek gönderebilmesi için mevcuttur.
Veriler sahte ama tutarlı. Bir ürünün başlığı, fiyatı, derecesi, stok sayısı ve kategorisi vardır. Bir kullanıcının adı, e-postası, adresi ve şirketi vardır. Bu tutarlılık, DummyJSON'ı gerçek gibi görünen tablolar, kartlar, sayfalama ve detay sayfalarını oluşturmak için faydalı kılar. Kayıtlar, üretim verilerinin genellikle olduğu gibi iç içe ve belirli türlerde olduğu için, önce kendi eklentilerinizi icat etmek zorunda kalmadan filtreler, sıralama kontrolleri ve detay görünümleri oluşturabilirsiniz.
DummyJSON her şeyi HTTPS üzerinden JSON olarak sunar, bu nedenle bir tarayıcıdan çekme, bir mobil uygulama, bir curl komutu veya sunucu tarafı bir betikten aynı şekilde çalışır. Kurulacak hiçbir şey yoktur. Bir URL'ye bir istek gönderirsiniz ve verileri geri alırsınız, bu da gerçek API henüz mevcut olmadığında bir projenin ilk saatlerinde tam olarak istediğiniz şeydir.
Bu bir öğrenme ve prototipleme aracıdır ve bu işte başarılıdır. Bir eğitimde veya hızlı bir demoda veri çekmek için bir uç noktaya ihtiyacınız olduğunda, size gerçekten zaman kazandırır.
DummyJSON uç noktaları, kimlik doğrulama ve sınırlar
DummyJSON çeşitli kaynak koleksiyonlarını ortaya çıkarır. Yaygın olanlar şunlardır:
/products, fiyat, stok ve derecelendirmeler içeren katalog öğeleri/users, adresleri, e-postaları ve şirket bilgileri olan kişiler/carts, kullanıcılara bağlı alışveriş sepetleri/postsve/comments, blog tarzı içerik/todos, görev öğeleri/recipesve/quotes, ek içerik kümeleri
Her koleksiyon, bir REST API'den bekleyeceğiniz kalıpları destekler. Tüm kayıtları alabilir, kimliğe göre tek bir kaydı alabilir, arama yapabilir, kategoriye göre filtreleyebilir ve limit ve skip ile sayfalama yapabilirsiniz. Bir select parametresi yanıtı belirli alanlara kırpar ve bir delay parametresi (0 ila 5000 ms) yavaş bir ağı simüle etmenizi sağlayarak yükleme durumlarını test etmenizi sağlar.
İşte temel bir okuma işlemi:
curl https://dummyjson.com/products?limit=5&skip=10
Kimlik doğrulama, bir oturum açma uç noktası ve bir taşıyıcı jeton kullanır. /auth/login adresine kimlik bilgileri gönderir, bir jeton alır ve bunu korumalı isteklere gönderirsiniz:
# 1. Jeton almak için oturum açın
curl -X POST https://dummyjson.com/auth/login \
-H 'Content-Type: application/json' \
-d '{"username":"emilys","password":"emilyspass"}'
# 2. Kimliği doğrulanmış bir istekte jetonu kullanın
curl https://dummyjson.com/auth/me \
-H 'Authorization: Bearer YOUR_ACCESS_TOKEN_HERE'
Yazma işlemleri de desteklenmektedir. POST, PUT, PATCH ve DELETE istekleri gönderebilirsiniz ve API, değişiklik gerçekleşmiş gibi yanıt verir. Ancak bir sorun var: bu yazma işlemleri simüle edilmiştir. DummyJSON, güncellenmiş veya oluşturulmuş gibi görünen bir kaydı geri yansıtır, ancak hiçbir şey kalıcı olmaz. Yenilediğinizde "yeni" ürününüz gitmiş olur. Bu, paylaşılan bir genel hizmet için bilerek yapılmıştır ve anlaşılması gereken en önemli tek sınırdır. Belgeler katı hız limitleri yayınlamaz, ancak herhangi bir ücretsiz paylaşılan uç noktayı nazikçe kullanın ve ona bir yük testi yönlendirmeyin.
DummyJSON'ın ötesindeki mevcut seçeneklere daha eksiksiz bir göz atmak için, geliştiriciler için ücretsiz API'lerin derlemesi birçok kategorideki seçenekleri kapsar.
DummyJSON, JSONPlaceholder ve Reqres Karşılaştırması
DummyJSON tek ücretsiz sahte REST API değildir. En çok karşılaştırıldığı iki diğer API, JSONPlaceholder ve Reqres'tir. Birbirleriyle örtüşseler de, her birinin farklı bir eğilimi vardır.
| Araç | En İyisi | Kaynaklar | Kimlik Doğrulama Akışı | Yazma İşlemleri Kalıcı mı? |
|---|---|---|---|---|
| DummyJSON | Gerçekçi e-ticaret tarzı demolar | Ürünler, kullanıcılar, sepetler, gönderiler, tarifler ve daha fazlası | Giriş uç noktası + taşıyıcı jeton | Hayır (simüle edilmiş) |
| JSONPlaceholder | Hızlı CRUD eğitimleri, minimum kurulum | Gönderiler, yorumlar, kullanıcılar, yapılacaklar, albümler, fotoğraflar | Yok | Hayır (simüle edilmiş) |
| Reqres | Kimlik doğrulama ve istek/yanıt akışı demoları | Kullanıcılar, kayıt/giriş taklitleri | Sahte kayıt/giriş | Hayır (simüle edilmiş) |
Üçünde de aynı kalıp geçerlidir. Sabit, çoğunlukla okunabilir veriler elde edersiniz, yazma işlemleri sahtedir ve geri gelenin şeklini değiştiremezsiniz. JSONPlaceholder arka planda json-server üzerinde çalışır, bu yüzden veri modeli bu kadar genel gelir. DummyJSON, gerçek bir mağazayı andıran veriler istediğinizde kazanır. Reqres, özellikle bir giriş ekranını demo yaparken kullanışlıdır.
Resmi kaynakları yer imlerinize eklemeye değer: JSONPlaceholder ve kendi kendine barındırmak veya kodu okumak isterseniz DummyJSON GitHub deposu.
Sabit yer tutucu veriler yeterli olmadığında
Barındırılan sahte API'ler, projeniz belirli hale geldiğinde hızla duvara çarpar. Bunu şu durumlarda hissedersiniz:
- Uygulamanızın DummyJSON'ın sahip olmadığı alanlara ihtiyacı var. Bir
subscription_tierveyafeature_flagsnesnesi şemada basitçe yoktur ve siz de ekleyemezsiniz. - Kalıcı yazma işlemlerine ihtiyacınız var. Bir sepet akışı veya yönetici paneli oluşturmak, bir kayıt oluşturup onu geri okumak demektir. Simüle edilmiş yazma işlemleri bu döngüyü bozar.
- Hata yollarını test etmeniz gerekiyor. Gerçek bir uygulamanın bir
429, bir500veya hatalı bir yükü yönetmesi gerekir. Sabit başarılı API'ler bunları talep üzerine üretmez. - Verileriniz kendi OpenAPI sözleşmenizle eşleşmeli, böylece gerçek sunucu gönderilmeden önce ön uç ve arka uç anlaşır.
İşte bu noktada başkasının sahte API'sini kullanmayı bırakıp kendi API'nizi oluşturmaya başlarsınız. Aynı arka uçsuz rahatlığı istersiniz, ancak kendi şemanızla, kendi alan adlarınızla ve kontrol ettiğiniz yanıtlarla.
Apidog ile kendi özel sahte REST API'nizi nasıl oluşturursunuz
Apidog, API'leri tek bir yerde tasarlayan, test eden, belgeleyen ve taklit eden bir API platformudur. Sabit verileri aştığınızda, barındırılan bir sahte API'nin yerini alan mock sunucusu bu parçadır. DummyJSON'ın ne döndürdüğünü kabul etmek yerine, uç noktayı ve veri şeklini tanımlarsınız ve Apidog eşleşen gerçekçi yanıtlar üretir. Devam etmek için Apidog'u indirin ve ücretsiz bir proje oluşturun.
İşte akış:
1. Uç noktanızı ve şemanızı tanımlayın. GET /products gibi bir uç nokta oluşturun ve yanıt alanlarını açıklayın: id, title, price, stock, category. Bunu elle yapabilir veya mevcut bir OpenAPI/Swagger dosyasını içe aktararak mock'un gerçek sözleşmenizle eşleşmesini sağlayabilirsiniz.
2. Akıllı mock'un verileri oluşturmasına izin verin. Apidog alan adlarınızı ve türlerinizi okur, ardından otomatik olarak mantıklı değerler üretir. email adlı bir alan bir e-posta döndürür, price bir sayı döndürür, createdAt bir tarih döndürür. Fixtürleri elle yazmaya gerek yoktur. Daha önce Faker kullandıysanız, bu platforma entegre edilmiş aynı fikirdir. OpenAPI şemalarından mock veri oluşturma kılavuzu, şema odaklı tarafı ayrıntılı olarak açıklar.
3. Değerleri ve uç durumları özelleştirin. price için belirli bir aralığa, status için sabit bir numaralandırmaya veya hata işlemeyi test etmek için kasıtlı bir 500 yanıtına mı ihtiyacınız var? Alan başına ve yanıt başına kurallar belirlersiniz. Barındırılan API'lerin yapamadığı kısım budur, çünkü tanıma siz sahipsiniz.
4. Mock sunucusunu çalıştırın ve çağırın. Apidog size canlı bir URL verir. Ön uç uygulamanızı tıpkı DummyJSON'a yönlendirdiğiniz gibi ona yönlendirin, ancak şimdi her alan ve durum kodu size aittir:
curl https://<your-mock-host>/products?limit=5
Mock, şemanızdan oluşturulduğu için, API spesifikasyonunuz değiştiğinde mock da onunla birlikte değişir. Sahte verileriniz ve gerçek sözleşmeniz asla birbirinden uzaklaşmaz. Daha gerçekçi, çeşitli veri kümeleri istiyorsanız, gerçekçi API test verileri oluşturma yaklaşımı, mock odaklı geliştirme ile iyi uyum sağlar.
Dürüst takas: DummyJSON, atılacak bir demo için hızda kazanır, çünkü yapılandıracak hiçbir şey yoktur. Apidog ise kendi şemanıza, kalıcı gibi hissettiren yazma işlemlerine, kontrol edilebilir hatalara veya göndereceğiniz gerçek API ile senkronize kalan bir mock'a ihtiyaç duyduğunuz anda kazanır.
Sıkça sorulan sorular
DummyJSON ücretsiz mi?
Evet. DummyJSON ücretsizdir ve API anahtarına ihtiyaç duymaz. Genel uç noktalarını doğrudan bir tarayıcıdan, curl'den veya uygulamanızdan çağırabilirsiniz. Herhangi bir paylaşılan ücretsiz hizmet gibi, üretim trafiği veya yük testi için değil, prototipleme ve öğrenme amaçlıdır.
DummyJSON oluşturduğum veya güncellediğim verileri kaydeder mi?
Hayır. POST, PUT, PATCH ve DELETE istekleri başarılı görünen bir yanıt döndürür, ancak sunucuda hiçbir şey kalıcı olmaz. Bir sonraki okuma, orijinal verileri döndürür. Gerçekten kalıcı yazma işlemlerine ihtiyacınız olduğunda, kendi mock'unuzu oluşturun. Mock API'leri kılavuzu, simüle edilmiş ve durum bilgisi olan mocklama arasındaki farkı açıklar.
DummyJSON ile mock sunucusu arasındaki fark nedir?
DummyJSON, herkesin paylaştığı sabit, barındırılan bir veri kümesidir. Apidog'daki gibi bir mock sunucusu ise, şemanıza karşı çalışır ve sizin tanımladığınız veri ve durum kodlarını döndürür. Genel demolar için DummyJSON'ı, verilerin kendi API'nizle eşleşmesi gerektiğinde ise bir mock sunucuyu kullanın.
Bariz yer tutucular yerine gerçekçi veriler alabilir miyim?
Evet, eğer bunu bir şemadan oluşturursanız. Şema odaklı araçlar, alan adlarınızı ve türlerinizi okur ve otomatik olarak inandırıcı değerler üretir, bu nedenle bir email alanı bir e-postaya, bir price ise bir fiyata benzer. Ekiplerin sabit bir sahte API'den kendi mock'larına geçmesinin ana nedeni budur.
Sonuç
DummyJSON sağlam bir ücretsiz sahte REST API'sidir. Gerçekçi görünen ürünler, kullanıcılar ve sepetler karşısında bir kullanıcı arayüzünü arka uç kodu yazmadan oluşturmanın en hızlı yoludur ve eğitimler veya hızlı prototipler için rakipsizdir. Sınırlar, kendi alanlarınıza, kalıcı yazma işlemlerine, kontrol edilebilir hatalara veya API sözleşmenizi takip eden verilere ihtiyaç duyduğunuzda ortaya çıkar.
Bu noktaya ulaştığınızda, sabit bir API ödünç almak yerine kendi özel sahte REST API'nizi oluşturun. Apidog, şemayı tanımlamanıza, ondan otomatik olarak gerçekçi veriler oluşturmanıza ve mock'u yayınlayacağınız API ile senkronize tutmanıza olanak tanır. Ücretsiz deneyin ve spesifikasyonunuzu dakikalar içinde çalışan bir mock'a dönüştürün.