# Criando uma especificação

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

Conteúdo Beta

Neste cenário, você usa as APIs do Talend para criar uma especificação para melhorar a qualidade do seu projeto.

## Sobre esta tarefa

Eis alguns detalhes sobre a chamada de API:

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

![API selecionada para obter todas as especificações.](https://help.qlik.com/Resources/Images/qlik-talend-cloud-migration-toolkit-user-guide/tcmp-specs-api.png)

## Procedimento

1. Chame o endpoint GET /api/v1/projects/quality/rules para obter todas as regras.
2. Anote o ID das regras que você deseja adicionar à nova especificação que você deseja criar.
3. Chame o endpoint POST /api/v1/projects/quality/specifications para criar uma especificação.
4. Na área Corpo, insira as seguintes informações:
   | Nome do parâmetro | Valor |
   | --- | --- |
   | nome | Insira o nome da regra. |
   | description | Insira a descrição da regra. |
   | rules | Insira um ou vários IDs de regra. |
   | operador | Especifique o operador de comparação para comparar com o limite: <=, \>=, =, \>= |
   | valor | Insira um valor para o limite. Esse valor define um limite ou fronteira, acima ou abaixo do qual uma condição deve ser observada. Este campo aceita valores numéricos a partir de 0. |
   | tipo | Insira um dos seguintes tipos de limite:<br>Porcentagem ou<br>Numérico. |

   Exemplo:
   ```
   {
     "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. Clique em Executar para fazer sua chamada.

## Resultados

A especificação é criada.