Collage du schéma formaté en JSON ou YAML dans votre navigateur
Copiez et collez le schéma au format JSON ou YAML dans votre navigateur.
Éditions requises
| Disponible avec : Lightning Experience |
| Disponible avec : Enterprise Edition, Performance Edition, Unlimited Edition et Developer Edition |
| Autorisations utilisateur requises | |
|---|---|
| Pour gérer les connexions : | Personnaliser l'application |
Pour enregistrer une spécification d'API en copiant et en collant son schéma conforme JSON ou YAML dans votre navigateur :
- Dans la Configuration de Lightning Experience, saisissez Services externes dans la case Recherche rapide, puis sélectionnez Services externes.
- Cliquez sur Nouveau service externe.
- Dans la page Sélectionner une source d'API, déterminez si vous importez une spécification d'API Depuis Mulesoft Anypoint Platform ou Depuis la spécification d'API. Comme nous utilisons notre propre spécification dans cet exemple, sélectionnez Depuis la spécification d'API.
- Sous Nom du service externe, saisissez un nom de service unique.
- Sous Description, saisissez une description, facultative. Une description courte et précise aide à différencier un service dans une longue liste de services.
- Cliquez sur sous Sélectionner un identifiant nommé, puis sélectionnez un identifiant nommé dans la liste.
- Sous Schéma du service, sélectionnez Schéma complet. Fournissez un schéma complet, valide pour OpenAPI 2.0 ou 3.0, et conforme JSON ou YAML.
- Collez votre schéma conforme JSON ou YAML dans le champ de texte fourni.
-
Cliquez sur Enregistrer et Suivant. Votre schéma chargé est validé par les Services externes.
Remarque Si votre schéma contient des types de média non pris en charge, le système affiche la page Associer des opérations à des types de média pris en charge. Sélectionnez un mappage valide pour chaque type non pris en charge, comme indiqué dans Mappage de types de média lors de l’inscription. -
Si une ou plusieurs erreurs sont détectées durant le processus de validation, un message (ou une série de messages) affiche des détails spécifiques sur les erreurs. Vous corrigez le schéma en le modifiant directement dans l'éditeur de texte et en cliquant sur Valider pour confirmer vos modifications, ou en modifiant une copie hors ligne et en l'enregistrant de nouveau. Il existe deux types d'erreur :
- Les erreurs de syntaxe ou logiques qui doivent être corrigées pour terminer le processus d’enregistrement. Pour corriger une erreur, consultez le message qui indique son type et son emplacement. Effectuez les modifications requises, puis cliquez sur Valider. Les messages d'erreur de syntaxe indiquent le numéro de ligne et de colonne de l'emplacement.
- Les avertissements syntaxes ou logiques qu’il n'est pas nécessaire de corriger pour effectuer un enregistrement. Cependant, les composants correspondants du schéma sont ignorés par les Services externes et ne sont pas inscrits. Pour résoudre les avertissements, consultez le message, effectuez les modifications requises, puis cliquez sur Valider.
- Sélectionnez les opérations que vous souhaitez importer dans l'inscription de votre service externe. Vous pouvez sélectionner jusqu'à 3 000 opérations par organisation et jusqu'à 3 000 objets actifs par organisation. Si vous dépassez l'une de ces limites, répartissez les opérations de votre schéma entre des inscriptions séparées. Pour plus d'informations sur les limites, consultez Considérations relatives aux services externes. Pour plus d'informations sur les « objets » dans les schémas Open API, consultez Basic Structure (OpenAPI 2.0) et Basic Structure (OpenAPI 3.0).
- Cliquez sur Suivant.
- Cliquez sur Terminé.
Cet article a-t-il résolu votre problème ?
Dites-nous ce que nous pouvons améliorer !
