Mock davranışı
Mock'lar, API sözleşmesine karşılık gelen isteklere çoğunlukla statik yanıtlar sağlar. API üzerinde tanımlanan herhangi bir güvenliği, istek yükünü veya istek başlıklarını (içerik pazarlığı için kullanılan Accept başlığı hariç) dikkate almadan isteklere yanıt verirler.
Bir istek yapıldığında mock, kullanıcının sağladığına (örnek, varsayılan değer, enum değeri) dayalı olarak veya yerleşik bir örnek değer kullanarak bir yanıt oluşturur.
Örneğin, istek bir nesne döndürüyorsa, sağlanmışsa nesnenin örneği kullanılır. Sağlanmamışsa, özelliklerin her birindeki örnekler kullanılır ve bundan bir JSON nesnesi oluşturulur. Bu, yanıt başlıkları için de geçerlidir.
Yanıtlar
- İşleminizin yalnızca bir yanıt aralığı varsa, aralıktaki ilk durum döndürülür. Örneğin, 2XX yanıt aralığına sahip bir işlem, 200 yanıtı döndürür.
- İşleminizin belirli bir yanıt kodu ve yanıt aralıkları veya varsayılan bir yanıtı varsa, tanımlanan kod döndürülür. Örneğin, 201 yanıtı ve 3XX yanıt aralığına sahip bir işlem, 201 yanıtını döndürür.
- İşleminizin birden fazla yanıt aralığı varsa ve tanımlanmış bir yanıt durumu yoksa, ilk aralığın ilk durumu döndürülür. Örneğin, 4XX ve 5XX yanıt aralığına sahip bir işlem, 400 yanıtı döndürür.
- İşleminizin yalnızca varsayılan bir yanıtı varsa, döndürülen yanıt işlem yöntemine bağlıdır:
- Kullanılan yöntem POST ise, 201 yanıtı döndürülür.
- Diğer yöntemler için, bir yanıt gövdesi tanımlanmamışsa 204 yanıtı döndürülür ve bir yanıt gövdesi tanımlanmışsa 200 yanıtı döndürülür.
- İşleminizin tanımlanmış bir yanıtı yoksa, 200 yanıtı döndürülür.
- 1XX yanıtları mock'lar tarafından desteklenmez. Bir işlemin 1XX yanıt aralığı veya bu aralıkta tanımlanmış bir yanıt kodu varsa, 404 yanıtı döndürülür.
Kombinasyonlar
- Tümü: bir örnek tanımlanmışsa, bu döndürülür. Veri türü için hiçbir örnek tanımlanmamışsa, türlerin özellikleri birleştirilir ve özellik düzeyinde tanımlanan örnekler kullanılır veya örnek değerler oluşturulur. Bir özellik farklı türlerde iki kez tanımlanmışsa, yalnızca son değer korunur. İlkel türler atılır, yalnızca nesneler döndürülür.
- Herhangi biri veya Biri: bir örnek tanımlanmışsa, bu döndürülür. Hiçbir örnek tanımlanmamışsa, listedeki ilk türden bir yanıt oluşturulur.
Kısıtlamalar
- Yalnızca istekte kullanılabilir: özellik, oluşturulan örnekten hariç tutulur.
- Yalnızca yanıtta kullanılabilir: özellik, oluşturulan örneğe dahil edilir.
- İstek ve yanıtta kullanılabilir: özellik, oluşturulan örneğe dahil edilir.
Veri türü düzeyinde sağlanan örnekler özelliklere göre önceliklidir. Yalnızca istekte kullanılabilir olarak tanımlanan bir özellik örneğe dahil edilmişse, yanıtta döndürülür. Yalnızca yanıtta kullanılabilir veya İstek ve yanıtta kullanılabilir olarak tanımlanan bir özellik örneğe dahil edilmemişse, yanıtta döndürülmez.