Les spécifications OpenAPI sont une collection d'outils qui vous aident à concevoir, construire, documenter et consommer des API.
Les spécifications OpenAPI sont similaires au Web Services Definition Language (WSDL) qui décrit des interactions entre le client et le serveur à l'aide de l'API REST. Pour plus d'informations, consultez la documentation spécification OpenAPI.
En plus d'intéractions client/serveur, un fichier de spécifications OpenAPI inclut également des descriptions pour les structures de données d'entrée et de sortie. Lorsque vous importez des fichiers de spécifications OpenAPI à l'aide de l'option JSON OpenAPI Specifications (Spécifications OpenAPI JSON), Talend Data Mapper extrait les descriptions des structures de données et crée une Structure avec une représentation JSON par défaut. Par exemple, consultez l'exemple YAML et l'exemple JSON.
Fonctionnalités supportées
-
Toutes les Structures importées sont simples. Les types primitifs dans les spécifications OpenAPI incluent le mélange habituel de type string, integer et float/double.
-
Les tableaux sont convertis en des éléments répétables dans Talend Data Mapper (Boucles).
-
La fonctionnalité de spécifications OpenAPI additionalProperties convertie en un groupe de type MAP dans Talend Data Mapper.
-
La construction allOf convertit naturellement en un héritage Talend Data Mapper.
-
Le oneOf and anyOf convertit en un Choix dans Talend Data Mapper.Remarque : Le Choix dans Talend Data Mapper ne correspond pas exactement à la sémantique de
anyOf. Dans le schéma d'exemple ci-après, remarquez que le JSON peut être un Chat, un Chien ou les deux. Talend Data Mapper ne supporte pas les deux cas.CatOrDog: anyOf: - $ref: '#/components/schemas/Cat' - $ref: '#/components/schemas/Dog'