Génération de réponses avec des mocks d'API
Les mocks d'API répondent aussi fidèlement que possible à tous les appels qu'ils reçoivent. Lors de la génération d'un corps de réponse, un mock donnera la priorité aux données fournies par l'utilisateur en recherchant un champ d'exemple, puis une valeur par défaut, puis un champ d'énumération. S'il en trouve un, il sera utilisé comme exemple ; sinon, un exemple JSON sera généré en fonction du type de données renvoyé par l'opération appelée.
À titre d'exemple, prenez la définition du type de données Company présentée ci-dessous. Elle ne contient pas d'exemples fournis par l'utilisateur.
Lorsque le mock est activé, un appel GET effectué vers la ressource /company/{companyId} retourne une réponse JSON automatiquement générée, basée sur la structure du type de données.
Le mock a effectué différentes opérations, notamment la génération de valeurs pour des en-têtes de réponse personnalisés (par exemple x-my-custom-header), l'identification de tableaux et la création d'exemples appropriés (comme la propriété tags), ainsi que l'identification de structures imbriquées et la génération de valeurs pour celles-ci (par exemple la propriété address).
Les mocks API Designer supportent la négociation de contenu ; vous pouvez donc utiliser l'en-tête de requête Accept afin de sélectionner le corps à retourner parmi les différentes options (chacune avec potentiellement son propre exemple) et donc changer les exemples retournées par le mock.
