Spécifications OpenAPI - 7.3

Guide d'utilisation de Talend Data Mapper

Version
7.3
Language
Français (France)
Product
Talend Big Data Platform
Talend Data Fabric
Talend Data Management Platform
Talend Data Services Platform
Talend MDM Platform
Talend Real-Time Big Data Platform
Module
Studio Talend
Content
Création et développement > Création de Jobs

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

La liste suivante regroupe des informations utiles lors de l'import des spécifications OpenAPI dans une Structure :
  • 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'