Les mocks fournissent principalement des réponses statiques aux requêtes correspondant au contrat de l'API. Ils répondent aux requêtes sans se soucier de la sécurité définie dans l'API, du payload de la requête ou des en-têtes de la requête (sauf l'en-tête Accept
utilisé pour la négociation de contenu).
Lorsqu'une requête est effectuée, le mock crée une réponse basée sur ce qu'a fourni l'utilisateur ou l'utilisatrice (exemple, valeur par défaut, valeur d'énumération), ou utilisant une valeur d'exemple built-in.
Par exemple, si la requête retourne un objet, l'exemple de l'objet est utilisé si vous en avez fourni un. Sinon, les exemples de chacune des propriétés sont utilisés et un objet JSON est créé à partir de ceci. Cela fonctionne également pour les en-têtes de réponses.
Réponses
- Si votre opération n'a qu'une famille de statut, le premier statut de cette plage est retourné. Par exemple, une opération avec une famille de statut
2XX
retourne une réponse200
. - Si votre opération contient un code de statut et une famille de statut spécifiques ou une réponse par défaut, le code défini est retourné. Par exemple, une opération avec une réponse
201
et une famille de statut3XX
retourne la réponse201
. - Si votre opération contient plus d'une famille de réponse et pas de statut de réponse défini, le premier statut de la première famille est retournée. Par exemple, une opération avec une plage de réponse
4XX
et5XX
retourne une réponse400
. - Si votre opération ne contient qu'une réponse par défaut, la réponse retournée dépend de la méthode d'opération :
- Si la méthode utilisée est
POST
, alors la réponse201
est retournée. - Pour d'autres méthodes, la réponse
204
est retournée si aucun corps de réponse n'est défini et une réponse200
est retournée si un corps de réponse est défini.
- Si la méthode utilisée est
- Si votre opération n'a pas de réponse définie, une réponse
200
est retournée. - Les réponses
1XX
ne sont pas supportées par les mocks. Si une opération a une plage de réponse1XX
ou un code de réponse défini dans cette plage, une réponse404
est retournée.
Combinaisons
- All of : si un exemple est défini, il est retourné. Si aucun exemple n'est défini pour le type de données, les propriétés de ces types sont fusionnées et les exemples définis au niveau de la propriété sont utilisés ou des valeurs d'exemples sont générées. Si une propriété est définie à deux reprises dans des types différents, seule la dernière valeur est préservée. Les types primitifs sont supprimés, seuls les objets sont retournés.
- Any of ou One of : si un exemple est défini, il est retourné. Si aucun exemple n'est défini, une réponse est générée à partir du premier type de la liste.
Restrictions
- Available in request only : la propriété est exclue de l'exemple généré.
- Available in response only : la propriété est incluse dans l'exemple généré.
- Available in request and response : la propriété est incluse dans l'exemple généré.
Les exemples fournis au niveau du type de données sont prioritaires sur les propriétés. Si une propriété définie comme Available in request only est incluse dans l'exemple, elle est retournée dans la réponse. Si une propriété définie comme Available in response only ou Available in request and response n'est pas incluse dans l'exemple, elle n'est pas retournée dans la réponse.