# Crear una especificación

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

Contenido beta

En este escenario, utilizaremos las API de Talend para crear una especificación y mejorar la calidad de su proyecto.

## Acerca de esta tarea

Aquí tiene algunos detalles sobre la llamada a la API:

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

![API seleccionada para obtener todas las especificaciones.](https://help.qlik.com/Resources/Images/qlik-talend-cloud-migration-toolkit-user-guide/tcmp-specs-api.png)

## Procedimiento

1. Llame al punto de conexión GET /api/v1/projects/quality/rules para obtener todas las reglas.
2. Anote el ID de las reglas que desea añadir a la nueva especificación que desea crear.
3. Llame al punto de conexión POST /api/v1/projects/quality/specifications para crear una especificación.
4. En el área Body, inserte la siguiente información:
   | Nombre del parámetro | Valor |
   | --- | --- |
   | nombre | Indique el nombre de la regla. |
   | descripción | Escriba la descripción de la regla. |
   | reglas | Introduzca uno o varios ID de regla. |
   | operador | Especifique el operador de comparación para comparar con el umbral: &lt;=,<br>\&gt;=,<br>=,<br>\&gt;= |
   | valor | Indique un valor para el umbral. Este valor establece un límite o umbral, por encima o por debajo del cual se deberá observar una condición. Este campo acepta valores numéricos a partir de 0. |
   | tipo | Introduzca uno de los siguientes tipos de umbral:<br>Porcentaje o<br>Numérico. |

   Ejemplo:
   ```
   {
     "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. Haga clic en Execute para realizar la llamada.

## Resultados

Se crea la especificación.