Onde e como devem ser descritas as regras de validação de entrada?

As regras de validação de entrada de dados devem estar descritas na especificação da API, por exemplo, no OpenAPI (Swagger) ou outro formato de documentação. Isto permite aos clientes e desenvolvedores compreender quais os dados esperados e quais as restrições aplicadas.

A descrição inclui:

• Tipos de dados (string, inteiro, booleano, etc.).
• Obrigatoriedade ou não dos campos.
• Formatos (por exemplo, email, data).
• Intervalos de valores ou comprimentos.
• Regras adicionais, como expressões regulares.

No servidor, estas regras são implementadas através da validação das requisições recebidas, garantindo a segurança e a correção dos dados.

Exemplo de descrição no OpenAPI:

parameters:
  - name: email
    in: query
    required: true
    schema:
      type: string
      format: email