Création d'une définition de contenu

Modifier en ligne

Une définition de contenu décrit le contenu d'une demande, d'une réponse ou d'un paramètre d'API. Vous pouvez créer des définitions de contenu à différents emplacements dans votre définition d'API.

Avant de commencer

Lancez la fenêtre de création de définition de contenu. Pour en savoir plus sur les zones de votre définition d'API à partir desquelles vous pouvez créer une définition de contenu, consultez les rubriques suivantes :

A propos de cette tâche

Remarque :
  • Cette tâche concerne la configuration d'une définition d'API OpenAPI 3.0. Pour plus de détails sur la configuration d'une définition d'API OpenAPI 2.0 , voir Edition d'une définition d'API OpenAPI 2.0.
  • Les API OpenAPI 3.0 sont prises en charge uniquement avec le DataPower® API Gatewayet non avec le DataPower Gateway (v5 compatible).
  • Pour plus de détails sur les limitations actuelles de la prise en charge d' OpenAPI 3.0 , voir Prise en charge d'OpenAPI 3.0 dans IBM® API Connect.

Vous pouvez effectuer cette tâche soit à l'aide de l'application d'interface utilisateur API Designer , soit à l'aide de l'interface utilisateur API Manager basée sur un navigateur.

À tout moment, vous pouvez accéder directement au fichier YAML source d' OpenAPI en cliquant sur l'icône Source OpenAPI Icône Source. Pour revenir au formulaire de conception, cliquez sur l'icône Formulaire Icône de formulaire.

Procédure

  1. Fournissez les informations suivantes :
    • Type de contenu: Sélectionnez le type de contenu ; par exemple, application / json.
      Remarque : bien que le champ « Type de contenu » de l'éditeur propose une liste de types de médias, vous pouvez spécifier une plage de types de médias en modifiant directement le code source de l'API ( OpenAPI ); par exemple, text/*, */json, ou */*. Pour les demandes ou les réponses qui correspondent à plusieurs types, seul le type le plus spécifique est applicable. Par exemple, text/plain remplace text/*.
  2. Cliquez sur Créer.
    Les détails de la définition du contenu s'affichent pour une modification ultérieure; voir Modification d'une définition de contenu.