# Creazione di una specifica

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

Contenuto beta

In questo scenario, si utilizzano le Talend API per creare una specifica per migliorare la qualità del progetto.

## Informazioni su questa attività

Ecco alcuni dettagli sulla chiamata API:

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

![API selezionata per ottenere tutte le specifiche.](https://help.qlik.com/Resources/Images/qlik-talend-cloud-migration-toolkit-user-guide/tcmp-specs-api.png)

## Procedura

1. Chiamare l'endpoint GET /api/v1/projects/quality/rules per ottenere tutte le regole.
2. Annotare l'ID delle regole che si desidera aggiungere alla nuova specifica che si desidera creare.
3. Chiamare l'endpoint POST /api/v1/projects/quality/specifications per creare una specifica.
4. Nell'area Corpo, inserire le seguenti informazioni:
   | Nome parametro | Valore |
   | --- | --- |
   | mancante | Inserire il nome della regola. |
   | descrizione | Inserisci la descrizione della regola. |
   | regole | Inserisci uno o più ID regola. |
   | operatore | Specificare l'operatore di confronto da confrontare con la<br>soglia: &lt;=,<br>\&gt;=,<br>=,<br>\&gt;= |
   | valore | Inserisci un valore per la soglia. Questo valore imposta un limite o un confine, al di sopra o al di sotto del quale una condizione dovrebbe essere osservata. Questo campo accetta valori numerici a partire da 0. |
   | tipo | Immettere uno dei seguenti tipi di soglia:<br>Percentuale o<br>Numerico. |

   Esempio:
   ```
   {
     "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. Fare clic su Esegui per effettuare la chiamata.

## Risultati

La specifica viene creata.