# Créer une spécification

Availability-note[Bêta](https://help.talend.com/r/en-US/Cloud/labels-on-talend-help-center/availability-beta)

Contenu bêta

Dans ce scénario, utilisez les API Talend pour créer une spécification afin d'améliorer la qualité de votre projet.

## Pourquoi et quand exécuter cette tâche

Voici quelques détails concernant l'appel d'API :

```
Method: POST
endpoint: api/v1/projects/quality/specifications
payload:[
  {
    "name": "string",
    "description": "string",
    "rules": [
      "string"
    ],
    "threshold": {
      "operator": "string",
      "value": 0,
      "type": "Percentage"
    }
  }
]
```

![API sélectionnée pour obtenir toutes les spécifications.](https://help.qlik.com/Resources/Images/qlik-talend-cloud-migration-toolkit-user-guide/tcmp-specs-api.png)

## Procédure

1. Appelez l'endpoint GET /api/v1/projects/quality/rules pour récupérer toutes les règles.
2. Notez l'ID des règles à ajouter à la spécification à créer.
3. Appelez l'endpoint POST /api/v1/projects/quality/specifications pour créer une spécification.
4. Dans la zone Body (Corps), saisissez les informations suivantes :
   | Nom du paramètre | Value (Valeur) |
   | --- | --- |
   | Name | Saisissez le nom de la règle. |
   | description | Saisissez la description de la règle. |
   | rules | Saisissez un ou plusieurs ID de règle·s. |
   | operator | Spécifiez l'opérateur de comparaison pour comparer au seuil : <=, \>=, =, \>= |
   | valeur | Saisissez une valeur pour le seuil. Cette valeur configure une limite, au-dessus ou au-dessous de laquelle la condition doit être respectée. Ce champ accepte les valeurs numériques à partir de 0. |
   | type | Saisissez l'un des types de seuils suivants : Percentage (Pourcentage) ou Numeric (Numérique). |

   Exemple :
   ```
   {
     "name": "cloud-migration", 
     "description": "This specification contains rules related best practices for Talend Cloud Migration", 
     "rules": [
         "30599ac4-09b0-4abd", "30599ac4-09b0-4abc" 
         ], 
         "threshold": {
             "operator": "=", 
             "value": 0, 
             "type": "PERCENTAGE" 
          }
   }
   ```
5. Cliquez sur Execute (Exécuter) pour émettre votre appel.

## Résultats

La spécification est créée.