# Spécifications OpenAPI

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](https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.0.md) (uniquement en anglais).

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), 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](https://help.qlik.com/talend/fr-FR/data-mapper-user-guide/8.0/yaml-example) et [l'exemple JSON](https://help.qlik.com/talend/fr-FR/data-mapper-user-guide/8.0/json-example).

## 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 (Boucles).

* La fonctionnalité de spécifications OpenAPI [additionalProperties](https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.0.md#schemaObject) (uniquement en anglais) convertie en un groupe de type MAP dans .

* La construction [allOf](https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.0.md#schemaObject) (uniquement en anglais) convertit naturellement en un héritage .

* Le [oneOf and anyOf](https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.0.md#schemaObject) (uniquement en anglais) convertit en un Choix dans .

  Note InformationsRemarque : Le Choix dans 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. ne supporte pas les deux cas.

  ```
  CatOrDog:
        anyOf:
          - $ref: '#/components/schemas/Cat'
          - $ref: '#/components/schemas/Dog'
  ```

### Dans cette section

* [Exemple YAML](https://help.qlik.com/talend/fr-FR/data-mapper-user-guide/8.0-R2026-04/yaml-example)
* [Exemple JSON](https://help.qlik.com/talend/fr-FR/data-mapper-user-guide/8.0-R2026-04/json-example)
* [Restrictions](https://help.qlik.com/talend/fr-FR/data-mapper-user-guide/8.0-R2026-04/restrictions)