Diferenças

Aqui você vê as diferenças entre duas revisões dessa página.

--- pres:gerti:gestao_de_ativos:portal:er_013 [28/04/2026 12:07] – [RN – Regras de Negócio] pramorim
+++ pres:gerti:gestao_de_ativos:portal:er_013 [22/06/2026 00:04] (atual) – pramorim
@@ Linha 169: / Linha 169: @@
 | 03 | Sistema valida que o campo de e-mail está preenchido | RN20 | Tela 03 |
 | 03.1 | Campo vazio → submissão não prossegue | RN20 | Tela 03 |
-| 04 | Campo preenchido → sistema registra a inscrição | RN21 | Tela 03 |
+| 04 | Campo preenchido → sistema envia requisição `POST` à API de newsletter com o e-mail informado | RN21, API01 | Tela 03 |
-| 05 | Sistema substitui o formulário pela mensagem de confirmação | | Tela 03 |
+| 04.1 | API retorna sucesso → sistema substitui o formulário pela mensagem de confirmação | RN21 | Tela 03 |
-| 06 | Sistema exibe "Inscrição realizada com sucesso!" e "[e-mail informado] foi adicionado à nossa lista." | | Tela 03 |
+| 04.2 | API retorna erro → sistema exibe mensagem de erro genérica sem expor detalhes técnicos | RN23 | Tela 03 |
+| 05 | Sistema exibe "Inscrição realizada com sucesso!" e "[e-mail informado] foi adicionado à nossa lista." | | Tela 03 |
 ---
@@ Linha 198: / Linha 199: @@
 | RN19 | **Copiar link — confirmação visual** — Ao copiar o link da notícia para a área de transferência, o sistema exibe uma confirmação visual no botão por 2 segundos, retornando ao estado padrão em seguida. Falhas silenciosas na operação de cópia não são sinalizadas ao usuário. |
 | RN20 | **Newsletter — campo de e-mail obrigatório** — A submissão do formulário de inscrição na newsletter exige que o campo de e-mail esteja preenchido. A ausência do valor impede o prosseguimento. |
-| RN21 | **Newsletter — confirmação de inscrição** — Após a submissão bem-sucedida, o formulário é substituído por uma mensagem de confirmação contendo o e-mail informado. |
+| RN21 | **Newsletter — confirmação de inscrição** — Após retorno de sucesso da API, o formulário é substituído por uma mensagem de confirmação contendo o e-mail informado. |
 | RN22 | **Contatos clicáveis no bloco de atendimento** — Os números de telefone do bloco de atendimento devem ser renderizados como links `tel:`, permitindo ao usuário iniciar uma chamada diretamente pelo dispositivo. Os endereços de e-mail devem ser renderizados como links `mailto:`, abrindo o cliente de e-mail padrão do dispositivo. Ambos seguem o mesmo estilo visual dos demais links da interface. |
+| RN23 | **Newsletter — tratamento de erro da API** — Em caso de falha na chamada à API de inscrição, o sistema exibe uma mensagem de erro genérica ao usuário ("Não foi possível realizar sua inscrição. Tente novamente.") sem expor detalhes técnicos. O formulário permanece visível para nova tentativa. |
+---
+===== APIs =====
+==== API01 – Cadastro na Newsletter ====
+^ Atributo ^ Valor ^
+| Método | `POST` |
+| URL | `https://catalogodeservicos.tce.go.gov.br/api/newsletter/cadastro` |
+| Autenticação | Não requerida |
+| Content-Type | `application/json` |
+**Corpo da requisição (DtoNewsletter):**
+<code json>
+{
+  "email": "string",
+  "id": 0
+}
+</code>
+^ Campo ^ Tipo ^ Obrigatório ^ Observação ^
+| `email` | string | Sim | E-mail informado pelo usuário no formulário |
+| `id` | number | Não | Enviar sempre como `0` para novos cadastros |
 ---