Efterliknar beteende
Senast uppdaterad: 2026-10-20Mocks ger huvudsakligen statiska svar på förfrågningar som motsvarar API-kontraktet. De svarar på förfrågningar utan hänsyn till eventuell säkerhet som definierats för API:et, förfrågans nyttolast eller förfrågerubriker (förutom rubriken Accept som används för innehållsförhandling).
När en förfrågan görs skapar mocken ett svar antingen baserat på vad användaren har angett (exempel, standardvärde, enum-värde), eller med hjälp av ett inbyggt exempelvärde.
Om begäran till exempel returnerar ett objekt används exemplet på objektet om ett sådant tillhandahålls. Om inte används exemplen för var och en av egenskaperna och ett JSON- objekt skapas utifrån det. Detta fungerar även för svarshuvuden.
Svar
- Om din operation endast har ett svarsintervall returneras den första statusen i intervallet. Till exempel returnerar en operation med ett 2XX-svarsintervall ett 200-svar.
- Om din operation har en specifik svarskod och svarsintervall eller ett standardsvar returneras den definierade koden. Till exempel returnerar en operation med ett 201-svar och ett 3XX-svarsintervall 201-svaret.
- Om din operation har flera svarsintervall och ingen definierad svarsstatus returneras den första statusen i det första intervallet. Till exempel returnerar en operation med ett svarsintervall på 4XX och 5XX ett 400-svar.
- Om din operation endast har ett standardsvar beror svaret som returneras
på operationsmetoden:
- Om metoden som används är POST returneras ett 201-svar.
- För andra metoder returneras ett 204-svar om ingen svarsbrödtext har definierats och ett 200-svar returneras om en svarsbrödtext har definierats.
- Om din operation inte har något definierat svar returneras ett 200-svar.
- 1XX svar stöds inte av mocks. Om en operation har svarsintervallet 1XX eller en definierad svarskod i detta intervall returneras ett 404-svar.
Kombinationer
- Alla av: om ett exempel är definierat returneras det. Om inget exempel har definierats för datatypen slås typernas egenskaper samman och exemplen som definierats på egenskapsnivå används, eller så genereras exempelvärden. Om en egenskap definieras två gånger i olika typer bevaras endast det sista värdet. Primitiva typer förkastas, endast objekt returneras.
- Något av eller Ett av: om ett exempel är definierat returneras det. Om inget exempel har definierats genereras ett svar från den första typen i listan.
Begränsningar
- Endast tillgänglig i begäran: egenskapen är utesluten från det genererade exemplet.
- Endast tillgänglig i svar: egenskapen inkluderas i det genererade exemplet.
- Tillgänglig i förfrågan och svar: egenskapen inkluderas i det genererade exemplet.
Exempel som tillhandahålls på datatypsnivå har företräde framför egenskaper. Om en egenskap som definierats som Endast tillgänglig i begäran inkluderas i exemplet returneras den i svaret. Om en egenskap som definierats som Endast tillgänglig i svar eller Tillgänglig i förfrågan och svar inte inkluderas i exemplet, returneras den inte i svaret.