Mockuje zachowanie
Ostatnia aktualizacja: 20.10.2026Mocki dostarczają głównie statyczne odpowiedzi na żądania, które są zgodne z kontraktem API. Odpowiadają na żądania bez uwzględniania jakichkolwiek zabezpieczeń zdefiniowanych w API, ładunku żądania ani nagłówków żądania (z wyjątkiem nagłówka Accept, który jest używany do negocjacji zawartości).
Gdy żądanie zostanie wysłane, mock tworzy odpowiedź albo na podstawie informacji podanych przez użytkownika (przykład, wartość domyślna, wartość typu enum), albo przy użyciu wbudowanej wartości przykładowej.
Na przykład, jeśli żądanie zwraca obiekt, używany jest przykład obiektu, jeśli został podany. W przeciwnym razie używane są przykłady z poszczególnych właściwości i na ich podstawie tworzony jest obiekt JSON. Działa to również w przypadku nagłówków odpowiedzi.
Odpowiedzi
- Jeśli Twoja operacja ma tylko zakres odpowiedzi, zwracany jest pierwszy status z tego zakresu. Na przykład operacja z zakresem odpowiedzi 2XX zwraca odpowiedź 200.
- Jeśli Twoja operacja ma określony kod odpowiedzi i zakresy odpowiedzi lub odpowiedź domyślną, zwracany jest zdefiniowany kod. Na przykład operacja z odpowiedzią 201 i zakresem odpowiedzi 3XX zwraca odpowiedź 201.
- Jeśli operacja ma kilka zakresów odpowiedzi i nie ma zdefiniowanego statusu odpowiedzi, zwracany jest pierwszy status z pierwszego zakresu. Na przykład operacja z zakresem odpowiedzi 4XX i 5XX zwraca odpowiedź 400.
- Jeśli Twoja operacja ma tylko odpowiedź domyślną, zwracana odpowiedź
zależy od metody operacji:
- Jeśli użyta metoda to POST, zwracana jest odpowiedź 201.
- W przypadku innych metod zwracana jest odpowiedź 204, jeśli nie zdefiniowano treści odpowiedzi, oraz zwracana jest odpowiedź 200, jeśli treść odpowiedzi została zdefiniowana.
- Jeśli Twoja operacja nie ma zdefiniowanej odpowiedzi, zwracana jest odpowiedź 200.
- Odpowiedzi 1XX nie są obsługiwane przez mocki. Jeśli operacja ma zakres odpowiedzi 1XX lub zdefiniowany kod odpowiedzi w tym zakresie, zwracana jest odpowiedź 404.
Kombinacje
- Wszystkie z: jeśli zdefiniowano przykład, jest on zwracany. Jeśli dla typu danych nie zdefiniowano żadnego przykładu, właściwości typów są scalane i używane są przykłady zdefiniowane na poziomie właściwości lub generowane są wartości przykładowe. Jeśli właściwość zostanie zdefiniowana dwukrotnie w różnych typach, zachowana zostanie tylko ostatnia wartość. Typy proste są odrzucane, zwracane są tylko obiekty.
- Dowolny z lub Jeden z: jeśli zdefiniowano przykład, jest on zwracany. Jeśli nie zdefiniowano żadnego przykładu, odpowiedź jest generowana na podstawie pierwszego typu z listy.
Ograniczenia
- Dostępne tylko w żądaniu: właściwość jest wykluczona z wygenerowanego przykładu.
- Dostępne tylko w odpowiedzi: właściwość jest uwzględniona w wygenerowanym przykładzie.
- Dostępne w żądaniu i odpowiedzi: właściwość jest uwzględniona w wygenerowanym przykładzie.
Przykłady podane na poziomie typu danych mają pierwszeństwo przed właściwościami. Jeśli właściwość zdefiniowana jako Dostępne tylko w żądaniu zostanie uwzględniona w przykładzie, jest zwracana w odpowiedzi. Jeśli właściwość zdefiniowana jako Dostępna tylko w odpowiedzi lub Dostępna w żądaniu i odpowiedzi nie jest uwzględniona w przykładzie, nie jest zwracana w odpowiedzi.