Skip to content

8. O servidor RdvMedecins, uma caixa-preta

Os exemplos 22 a 25, seguidos do estudo de caso, interagem com um servidor: o servidor JSON da aplicação [RdvMedecins]. Este é o servidor [NestJS] dos cursos [React], [Vue.js], [Angular] e [Flutter]: o servidor do curso de [NestJS], cujos controllers não geram mais páginas HTML, mas produzem respostas JSON. Os leitores destas lições já conhecem este capítulo, que é reproduzido aqui quase sem alterações; basta consultarem a seção sobre autenticação, que explica o que muda para uma aplicação [Ionic] instalada em um celular.

Neste curso, este servidor é uma caixa-preta: você não precisa saber como ele é escrito. Importa apenas a sua API—ou seja, a lista de requisições HTTP que ele aceita e as respostas que retorna. Esta é a situação típica de um desenvolvedor de clientes: a API é um contrato, e a equipe do servidor pode mudar o que quiser por trás desse contrato. Seu código-fonte é fornecido (pasta [rdvmedecins-nestjs-json]) e amplamente comentado, para o leitor curioso.

Este capítulo explica como instalar o servidor, descreve sua API e a consulta usando [curl].

8.1. A aplicação RdvMedecins

A aplicação gerencia as consultas de um consultório médico. Ela tem três papéis:

Papel
Quem
O que pode fazer
[ADMIN]
O administrador ([admin])
Agendar e cancelar consultas de todos os pacientes; gerenciar médicos e clientes
[DOCTOR]
Médicos ([pelissier], [tatou], [dupont])
Agendar e cancelar consultas de todos os pacientes; ver todos os nomes nas agendas
[USER]
Pacientes ([martin], [durand], [bistrou], [german])
marcar consultas para si mesmos; cancelar suas consultas; gerenciar suas contas. Em uma agenda, não podem ver os nomes de outros pacientes

As contas de demonstração usam o login como senha. As regras de gestão são verificadas pelo servidor, independentemente do cliente:

  • nenhuma consulta no passado;
  • apenas uma consulta futura por paciente;
  • um horário só pode ser reservado uma vez por dia;
  • dois médicos (ou dois clientes) não podem ter o mesmo nome e sobrenome; um login pertence a uma única conta;
  • um médico com consultas agendadas não pode ser excluído;
  • Um registro que tenha sido modificado nesse meio-tempo por outra pessoa não pode ser sobrescrito (bloqueio otimista);
  • Um paciente nunca recebe o nome de outro paciente.

8.2. Instalação

Você precisa do [Node.js] (já instalado para o [Angular]; veja o Capítulo 2) e de um servidor [MySQL] (ou [MariaDB]): a instalação deles é descrita no apêndice.

1. O banco de dados. O script [database/dbrdvmedecins2.sql] cria o banco de dados [dbrdvmedecins2], suas tabelas e seus dados de exemplo. Usando o [Laragon], execute-o a partir do [HeidiSQL] (menu File / Run a SQL file); na linha de comando:

mysql -u root -p < database/dbrdvmedecins2.sql

O script sempre começa com um banco de dados vazio: você pode executá-lo novamente para restaurar os dados iniciais.

2. Bibliotecas. Em uma janela de console aberta na pasta [rdvmedecins-nestjs-json]:

npm install

3. Configuração. Copie o arquivo [.env.example] para [.env] (no [Windows]: [copy .env.example .env]) e depois modifique-o:

# -----------------------------------------------------------------------
# Arquivo de configuração de exemplo.
# Copie este arquivo para [.env] e depois adapte os valores à sua máquina.
# O arquivo [.env] nunca deve ser compartilhado nem commitado (senhas).
# -----------------------------------------------------------------------

# porta de escuta do servidor JSON
PORT=8080

# parâmetros de conexão com o banco de dados MySQL [dbrdvmedecins2]
# (script: database/dbrdvmedecins2.sql)
DB_HOST=localhost
DB_PORT=3306
DB_USERNAME=root
DB_PASSWORD=
DB_DATABASE=dbrdvmedecins2
# true: exibe no console as consultas SQL enviadas ao MySQL
DB_LOGGING=false

# -----------------------------------------------------------------------
# autenticação
# -----------------------------------------------------------------------
# chave secreta usada para assinar/verificar tokens JWT - DEVE ser alterada
# em produção (uma string aleatória longa, nunca commitada).
JWT_SECRET=change-me-to-a-long-random-string
# validade de um token JWT, em segundos (7200 s = 2 h). O cookie
# que transporta o token tem a mesma duração.
JWT_EXPIRES_IN_SECONDS=7200
# defina como true em produção (site servido por HTTPS): o cookie de
# autenticação nunca será então enviado por uma conexão não criptografada.
COOKIE_SECURE=false

# -----------------------------------------------------------------------
# proteção contra bots
# -----------------------------------------------------------------------
# login: número de falhas (captcha ou senha incorretos) permitidas para
# o mesmo login a partir do mesmo endereço IP, antes que esse par seja bloqueado...
LOGIN_MAX_FAILURES=5
# ... por esta duração (um endereço IP também é bloqueado se acumular
# 5 vezes mais falhas, todos os logins somados)
LOGIN_BLOCK_MINUTES=15
# criação de conta de cliente: número máximo de contas criadas por hora
# a partir do mesmo endereço IP. Em uma sala de aula, todos os computadores muitas vezes saem
# pelo mesmo endereço: aumente se necessário.
REGISTRATION_MAX_PER_HOUR=10

# MODO DE TESTE do captcha: se esta variável tiver um valor, esse valor é
# aceito como resposta a QUALQUER captcha. Útil para consultar
# a API com curl (não é possível "ler" a imagem em um console).
# Deixe VAZIA em produção.
CAPTCHA_TEST=

# -----------------------------------------------------------------------
# produção
# -----------------------------------------------------------------------
# pasta do cliente web compilado, servido por este servidor (padrão: client/)
# CLIENT_DIR=client
# defina como true se o servidor estiver atrás de um proxy (nginx...)
TRUST_PROXY=false
  • linha 8: o servidor escuta na porta 8080;
  • linhas 12–16: a conexão com o [MySQL]. Com o [Laragon], o usuário [root] não tem senha: os valores padrão servem;
  • linha 25: a chave secreta que assina os tokens de autenticação;
  • linhas 38–45: medidas antibot: após 5 tentativas de login malsucedidas para o mesmo nome de usuário a partir do mesmo endereço IP (IP), essa combinação é bloqueada por 15 minutos; um mesmo endereço IP (IP) não pode criar mais de 10 contas por hora. Durante o desenvolvimento da aplicação—quando os erros são frequentes—, você pode encontrar esses valores no seu arquivo [.env];
  • linha 51: o modo de teste do CAPTCHA. A página de login pede que você digite novamente os caracteres de uma imagem, o que é impossível a partir de um console. Se esta variável tiver um valor, esse valor é aceito como resposta a qualquer CAPTCHA, assim como as “chaves de teste” que o [Google] fornece para o seu [reCAPTCHA]. Para os testes com [curl] neste capítulo, informe [CAPTCHA_TEST=test]. Os scripts que geraram as capturas de tela deste curso também usam esse valor. Deixe-a vazia em produção;
  • linhas 57–59: duas configurações para produção (veja o capítulo “Implantação”).

4. Inicialização.

npm run start:dev

O console exibe (trecho; [start:dev] reinicia o servidor toda vez que seu código é modificado):

[Nest] 13189  - 10/06/2026, 1:29:56 PM     LOG [NestFactory] Starting Nest application...
[Nest] 13189  - 10/06/2026, 1:29:56 PM     LOG [InstanceLoader] TypeOrmModule dependencies initialized +19ms
...
[Nest] 13189  - 10/06/2026, 1:29:56 PM    WARN [RdvMedecins] captcha TEST MODE active (CAPTCHA_TEST in .env): never use it in production
[Nest] 13189  - 10/06/2026, 1:29:56 PM     LOG [RoutesResolver] ScheduleController {/api/schedule}: +1ms
[Nest] 13189  - 10/06/2026, 1:29:56 PM     LOG [RouterExplorer] Mapped {/api/schedule, GET} route +1ms
[Nest] 13189  - 10/06/2026, 1:29:56 PM     LOG [RoutesResolver] AppointmentsController {/api/appointments}: +0ms
...
[Nest] 13189  - 10/06/2026, 1:29:56 PM     LOG [RouterExplorer] Mapped {/api/auth/me, GET} route +0ms
[Nest] 13189  - 10/06/2026, 1:29:56 PM     LOG [NestApplication] Nest application successfully started +6ms
[Nest] 13189  - 10/06/2026, 1:29:56 PM     LOG [RdvMedecins] JSON server started: http://localhost:8080/api

Cada linha [Mapped] anuncia uma rota da API. Se o banco de dados estiver inacessível (servidor [MySQL] parado, senha incorreta), o servidor é encerrado imediatamente com uma mensagem de erro de conexão.

8.3. Formato das respostas

Todas as rotas começam com [/api]. Uma requisição bem-sucedida recebe um código de status 2xx e, no corpo, os dados solicitados no formato JSON. Uma requisição rejeitada recebe um código de status 4xx ou 5xx e, no corpo, dados no mesmo formato:

1
2
3
4
5
6
{
  "statusCode": 400,
  "key": "ERRORS.INVALID_FORM",
  "params": { "min": "6" },
  "fields": { "lastName": "ERRORS.LASTNAME_REQUIRED", "password": "ERRORS.PASSWORD_TOO_SHORT" }
}
  • [statusCode]: o código HTTP, repetido no corpo;
  • [key]: a chave de tradução da mensagem. O servidor nunca retorna texto para ser exibido: ele não conhece o idioma do usuário. É o cliente que traduz a chave usando seus dicionários (veja o Exemplo 21);
  • [params] (opcional): parâmetros da mensagem (“Pelo menos {{min}} caracteres”, “Tente novamente em {{minutes}} minuto(s)”;
  • [fields] (opcional): para um formulário rejeitado, o erro de cada campo.

Códigos usados:

Código
Significado
Exemplos de chaves
400
Requisição inválida
[ERRORS.INVALID_FORM] (+ fields), [ERRORS.INVALID_DATE], [ERRORS.WRONG_CAPTCHA], [ERRORS.CHOOSE_PATIENT], [ERRORS.WRONG_CURRENT_PASSWORD], [ERRORS.BAD_REQUEST]...
401
não autenticado
[ERRORS.AUTH_REQUIRED] (sem token), [ERRORS.SESSION_EXPIRED] (token inválido ou expirado), [LOGIN.ERROR]
403
Acesso negado
[ERRORS.FORBIDDEN] (papel insuficiente), [ERRORS.CAPTCHA_BEFORE_ACCOUNT] (sem passe)
404
Não encontrado
[ERRORS.NOT_FOUND], [ERRORS.DOCTOR_NOT_FOUND], [ERRORS.APPOINTMENT_NOT_FOUND]...
409
Violação de regra de negócio
[ERRORS.PAST_DATE], [ERRORS.SLOT_ALREADY_BOOKED], [ERRORS.LOGIN_TAKEN], [ERRORS.CONCURRENT_UPDATE]...
415
POST que não está em JSON
[ERRORS.JSON_REQUIRED]
429
Tentativas em excesso
[ERRORS.TOO_MANY_ATTEMPTS], [ERRORS.TOO_MANY_ACCOUNTS] (+ params.minutes)
500
erro do servidor
[ERRORS.SERVER_ERROR]

8.4. Autenticação

O cliente se autentica usando [POST /api/auth/login], com um nome de usuário, uma senha e uma resposta ao CAPTCHA. Em retorno, o servidor envia, no cabeçalho [Set-Cookie] de sua resposta, um cookie contendo um token JWT assinado:

Set-Cookie: rdvmedecins_jwt=eyJhbGciOiJIUzI1NiIs...; Max-Age=7200; Path=/api; Expires=Tue, 06 Oct 2026 14:12:15 GMT; HttpOnly; SameSite=Strict

O cliente deve então incluir esse cookie no cabeçalho [Cookie] de toda requisição a [/api]: é assim que o servidor sabe quem está fazendo a requisição.

Este servidor foi projetado para clientes web, e suas escolhas de projeto são guiadas pelos riscos específicos dos navegadores web:

  • [HttpOnly]: o código [JavaScript] da página não consegue ler esse cookie. Um script malicioso injetado na página seria, portanto, incapaz de roubar o token. Consequência para o cliente: ele não consegue determinar por conta própria se está logado. Ele pergunta ao servidor ([GET /api/auth/me]);
  • [Path=/api]: o cookie só é incluído nas requisições à API;
  • [SameSite=Strict]: o navegador só inclui o cookie em requisições enviadas a partir de uma página deste site. Uma página maliciosa em outro site não consegue fazer o navegador agir em nome do usuário (o chamado ataque CSRF);
  • [Max-Age=7200]: ele expira após duas horas, ao mesmo tempo que o token.

Uma segunda proteção contra ataques CSRF: o servidor rejeita (415) qualquer requisição POST cujo corpo não esteja em JSON. Um formulário HTML comprometido em outro site não consegue enviar JSON.

8.4.1. O que muda para um cliente mobile

Uma aplicação [Ionic] é uma aplicação web executada no celular por uma “WebView” (o motor de navegador [Chrome] do [Android]): ela segue as mesmas regras de um navegador? Neste curso, precisamos distinguir as duas formas como ela é executada.

No navegador do computador, durante o desenvolvimento ([ng serve]). A aplicação é servida pelo servidor de desenvolvimento do [Angular] (http://localhost:8100); o servidor JSON está em outra porta (8080). São duas origens diferentes, e o navegador aplicaria duas regras problemáticas: ele não aceitaria respostas de uma origem diferente, a menos que autorizadas pelo servidor (o mecanismo “CORS”, que nosso servidor não suporta), e não incluiria o cookie [SameSite=Strict] em requisições “de outro site”. A solução é a mesma dos cursos de [React] e [Vue.js] : um proxy. O servidor de desenvolvimento encaminha ao servidor JSON qualquer requisição cujo endereço comece com [/api] (arquivo [proxy.conf.json], veja o Exemplo 22). Do ponto de vista do navegador, a aplicação e a API têm a mesma origem: o navegador armazena o cookie e o envia de volta, e o código da aplicação não precisa fazer nada.

No celular ([Android], [Capacitor]). A página é servida pelo próprio [Capacitor] , a partir do endereço https://localhost; o servidor JSON está no computador, em um endereço como http://10.0.2.2:8080 (veja o Exemplo 22). Novamente, há duas origens. O projeto ativa o plugin [CapacitorHttp] do [Capacitor] (arquivo [capacitor.config.ts]): as requisições HTTP da aplicação deixam de ser enviadas pela WebView e passam a ser enviadas pelo código nativo do [Android]. Consequências:

  • não há mais verificação de CORS: essa verificação é uma regra de navegador, e o código nativo não é um navegador (nem o [curl]);
  • os cookies recebidos são armazenados pelo [Android] (seu gerenciador de cookies, o mesmo da WebView) e reenviados automaticamente nas requisições seguintes ao mesmo servidor. Eles são mantidos no dispositivo: você continua logado quando fecha e reabre o aplicativo;
  • os atributos [HttpOnly] e [SameSite] não causam nenhum problema: o código da aplicação nunca lê o cookie (ele pergunta a [GET /api/auth/me] quem está logado), e a requisição não é enviada por uma página “de outro site”.

Esta é uma diferença importante em relação ao curso de [Flutter]: uma aplicação [Flutter] não tem navegador e precisava escrever seu próprio cliente HTTP, que lê o cabeçalho [Set-Cookie] nas respostas e escreve o cabeçalho [Cookie] nas requisições. Com o [Ionic], tanto no navegador quanto no celular, o cookie é repassado sem uma única linha de código. O servidor, por sua vez, não precisa mudar nada: ele vê apenas requisições HTTP comuns, que incluem o cookie que ele definiu.

8.5. A API

Método
Endereço
Papéis
Corpo enviado/resposta
GET
[/api/captcha]
público
Resposta: [{ id, svg }]
POST
[/api/auth/login]
público
[{ login, password, captchaId, captcha }]; resposta: [{ login, name, role }] + cookie
POST
[/api/auth/logout]
público
[{}] ; exclui o cookie
GET
[/api/auth/me]
logado
resposta: [{ login, name, role }]
GET
[/api/schedule?doctorId=&day=]
todos
Resposta: a agenda (sem doctorId: para um DOCTOR, a sua própria)
POST
[/api/appointments]
todos
[{ day, slotId, clientId }] (clientId ignorado para um USER); 201
DELETE
[/api/appointments/:id]
todos
Um USER cancela somente as suas próprias
GET
[/api/doctors]
todos
a lista (com login para ADMIN)
GET
[/api/clients]
ADMIN, DOCTOR
a lista (com login para ADMIN)
GET
[/api/doctors/:id], [/api/clients/:id]
ADMIN
um registro
POST
[/api/doctors], [/api/clients]
ADMIN
[{ title, firstName, lastName, login?, password? }]; 201
PUT
[/api/doctors/:id], [/api/clients/:id]
ADMIN
[{ title, firstName, lastName, login?, password?, version }]
DELETE
[/api/doctors/:id], [/api/clients/:id]
ADMIN
Resposta: [{}]
POST
[/api/register/access]
público
[{ captchaId, captcha }]; emite um token (cookie)
GET
[/api/register/access]
público
resposta: [{ valid }]
POST
[/api/register]
público + passe
[{ title, firstName, lastName, login, password, confirmation }]; 201
GET
[/api/my-area]
USER
Resposta: [{ patient, appointments }]
GET
[/api/my-account]
USER
Resposta: [{ title, firstName, lastName, login, version }]
PUT
[/api/my-account]
USER
[{ title, firstName, lastName, login, password?, confirmation?, currentPassword, version }]
DELETE
[/api/my-account]
USER
[{ currentPassword }]; exclui a conta e suas consultas

Uma entrada da agenda ([GET /api/schedule]) descreve um horário E o que o usuário logado está autorizado a fazer com ele:

1
2
3
4
{ "id": 3, "startHour": 8, "startMinute": 40, "endHour": 9, "endMinute": 0,
  "free": false,
  "patient": { "title": "Mme", "firstName": "Alice", "lastName": "DURAND" },
  "mine": false, "bookable": false, "appointmentId": 2 }
  • [free]: o horário está disponível nesse dia?
  • [patient]: o paciente da consulta. Para um paciente logado, é igual a [null], exceto para a SUA PRÓPRIA (consulta): os nomes de outros pacientes nunca são enviados;
  • [mine]: esta é a consulta do paciente logado;
  • [bookable]: o usuário pode reservar este horário (disponível, não no passado e, no caso de um paciente, sem consultas futuras)?
  • [appointmentId]: preenchido se o usuário pode cancelar esta consulta.

O servidor DECIDE; o cliente exibe. E mesmo que um cliente trapaceasse (exibindo um botão “Reservar” quando não deveria), o servidor verificaria tudo novamente no momento da reserva.

8.6. Consultando a API com curl

A pasta [curl] do servidor contém os corpos JSON das requisições deste capítulo, um arquivo por requisição. Por exemplo, [curl/login-admin.json]:

{ "login": "admin", "password": "admin", "captchaId": "-", "captcha": "test" }

Os comandos são digitados em um console aberto no diretório [rdvmedecins-nestjs-json], com o servidor em execução no modo de teste do CAPTCHA ([CAPTCHA_TEST=test]) sobre um banco de dados recém-(re)inicializado. Algumas opções do [curl]:

  • [-i]: exibe também os cabeçalhos da resposta; [-s]: sem barra de progresso;
  • [--json @file]: envia o conteúdo do arquivo em POST, com o cabeçalho [Content-Type: application/json] ([curl] 7.82 e posteriores; com uma versão mais antiga, use [-H "Content-Type: application/json" -d @file]);
  • [-X PUT], [-X DELETE]: o método HTTP;
  • [-c cookies.txt]: salva os cookies recebidos neste arquivo; [-b cookies.txt]: envia-os de volta. É assim que o [curl] “continua logado” de um comando para o seguinte, exatamente como um navegador faria.

No [PowerShell], você deve digitar [curl.exe] e não [curl] (que se refere a um comando diferente). A saída a seguir vem de uma sessão real (6 de outubro de 2026, com consultas agendadas para janeiro de 2030, para que ainda estejam no futuro). As respostas JSON, um tanto longas, foram formatadas para este documento (uma linha por objeto), enquanto os tokens JWT e a imagem do CAPTCHA foram truncados (“... ”), e os cabeçalhos [Date], [ETag], [Connection] e [Keep-Alive] foram removidos.

8.6.1. Login

Primeiro, o CAPTCHA (a imagem está truncada):

1
2
3
4
5
6
7
$ curl -i http://localhost:8080/api/captcha
HTTP/1.1 200 OK
Cache-Control: no-store
Content-Type: application/json; charset=utf-8
Content-Length: 13195

{"id":"8f711d55-566c-44e6-b02b-f114a02279f6","svg":"<svg xmlns=\"http://www.w3.org/2000/svg\" width=\"150..."}

Sem um token, uma URL protegida retorna uma resposta 401:

1
2
3
4
5
6
$ curl -i http://localhost:8080/api/doctors
HTTP/1.1 401 Unauthorized
Content-Type: application/json; charset=utf-8
Content-Length: 47

{"statusCode":401,"key":"ERRORS.AUTH_REQUIRED"}

Um CAPTCHA incorreto, seguido de uma senha incorreta:

1
2
3
4
5
6
$ curl -i --json @curl/login-wrong-captcha.json http://localhost:8080/api/auth/login
HTTP/1.1 400 Bad Request
Content-Type: application/json; charset=utf-8
Content-Length: 91

{"statusCode":400,"key":"ERRORS.WRONG_CAPTCHA","fields":{"captcha":"ERRORS.WRONG_CAPTCHA"}}
1
2
3
4
5
6
$ curl -i --json @curl/login-wrong-password.json http://localhost:8080/api/auth/login
HTTP/1.1 401 Unauthorized
Content-Type: application/json; charset=utf-8
Content-Length: 38

{"statusCode":401,"key":"LOGIN.ERROR"}

Um login bem-sucedido define o cookie, que o [curl] armazena em [cookies.txt]:

1
2
3
4
5
6
7
$ curl -i -c cookies.txt --json @curl/login-admin.json http://localhost:8080/api/auth/login
HTTP/1.1 200 OK
Set-Cookie: rdvmedecins_jwt=eyJhbGciOiJIUzI1NiIs...; Max-Age=7200; Path=/api; Expires=Tue, 06 Oct 2026 14:12:15 GMT; HttpOnly; SameSite=Strict
Content-Type: application/json; charset=utf-8
Content-Length: 55

{"login":"admin","name":"Administrator","role":"ADMIN"}

Com este cookie, o servidor sabe quem somos:

1
2
3
4
5
6
$ curl -i -b cookies.txt http://localhost:8080/api/auth/me
HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
Content-Length: 55

{"login":"admin","name":"Administrator","role":"ADMIN"}

Um token forjado (ou expirado) resulta em uma sessão expirada, e o servidor solicita que o cookie seja excluído (uma data de expiração já vencida):

1
2
3
4
5
6
7
$ curl -i -b "rdvmedecins_jwt=abc.def.ghi" http://localhost:8080/api/auth/me
HTTP/1.1 401 Unauthorized
Set-Cookie: rdvmedecins_jwt=; Path=/api; Expires=Thu, 01 Jan 1970 00:00:00 GMT
Content-Type: application/json; charset=utf-8
Content-Length: 49

{"statusCode":401,"key":"ERRORS.SESSION_EXPIRED"}

8.6.2. Médicos, clientes, agenda

A lista de médicos, como vista pelo ADMIN (com os logins):

$ curl -i -b cookies.txt http://localhost:8080/api/doctors
HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
Content-Length: 282

[
  {"id":3,"version":0,"title":"Melle","firstName":"Sophie","lastName":"DUPONT","login":"dupont"},
  {"id":1,"version":0,"title":"Mme","firstName":"Marie","lastName":"PELISSIER","login":"pelissier"},
  {"id":2,"version":0,"title":"Mr","firstName":"Paul","lastName":"TATOU","login":"tatou"}
]

A agenda da Dra. PELISSIER para 15 de janeiro de 2030:

$ curl -s -b cookies.txt "http://localhost:8080/api/schedule?doctorId=1&day=2030-01-15"
{
  "doctor":{"id":1,"version":0,"title":"Mme","firstName":"Marie","lastName":"PELISSIER"},
  "day":"2030-01-15",
  "slots":[
    {"id":1,"startHour":8,"startMinute":0,"endHour":8,"endMinute":20,"free":true,"patient":null,"mine":false,"bookable":true,"appointmentId":null},
    {"id":2,"startHour":8,"startMinute":20,"endHour":8,"endMinute":40,"free":true,"patient":null,"mine":false,"bookable":true,"appointmentId":null},
    {"id":3,"startHour":8,"startMinute":40,"endHour":9,"endMinute":0,"free":true,"patient":null,"mine":false,"bookable":true,"appointmentId":null},
    {"id":4,"startHour":9,"startMinute":0,"endHour":9,"endMinute":20,"free":true,"patient":null,"mine":false,"bookable":true,"appointmentId":null},
    {"id":5,"startHour":9,"startMinute":20,"endHour":9,"endMinute":40,"free":true,"patient":null,"mine":false,"bookable":true,"appointmentId":null},
    {"id":6,"startHour":9,"startMinute":40,"endHour":10,"endMinute":0,"free":true,"patient":null,"mine":false,"bookable":true,"appointmentId":null},
    {"id":7,"startHour":10,"startMinute":0,"endHour":10,"endMinute":20,"free":true,"patient":null,"mine":false,"bookable":true,"appointmentId":null},
    {"id":8,"startHour":10,"startMinute":20,"endHour":10,"endMinute":40,"free":true,"patient":null,"mine":false,"bookable":true,"appointmentId":null},
    {"id":9,"startHour":10,"startMinute":40,"endHour":11,"endMinute":0,"free":true,"patient":null,"mine":false,"bookable":true,"appointmentId":null},
    {"id":10,"startHour":11,"startMinute":0,"endHour":11,"endMinute":20,"free":true,"patient":null,"mine":false,"bookable":true,"appointmentId":null},
    {"id":11,"startHour":11,"startMinute":20,"endHour":11,"endMinute":40,"free":true,"patient":null,"mine":false,"bookable":true,"appointmentId":null},
    {"id":12,"startHour":11,"startMinute":40,"endHour":12,"endMinute":0,"free":true,"patient":null,"mine":false,"bookable":true,"appointmentId":null}
  ],
  "info":null
}

Uma data que não existe:

1
2
3
4
5
6
$ curl -i -b cookies.txt "http://localhost:8080/api/schedule?doctorId=1&day=2030-02-30"
HTTP/1.1 400 Bad Request
Content-Type: application/json; charset=utf-8
Content-Length: 46

{"statusCode":400,"key":"ERRORS.INVALID_DATE"}

8.6.3. Consultas

O ADMIN reserva o horário 3 para o paciente nº 2 (Alice DURAND). O corpo da requisição ([curl/appointment-admin.json]):

{ "day": "2030-01-15", "slotId": 3, "clientId": 2 }
1
2
3
4
5
6
$ curl -i -b cookies.txt --json @curl/appointment-admin.json http://localhost:8080/api/appointments
HTTP/1.1 201 Created
Content-Type: application/json; charset=utf-8
Content-Length: 51

{"id":2,"day":"2030-01-15","slotId":3,"clientId":2}

A agenda agora exibe esta consulta, junto com o nome do paciente e as instruções para cancelá-la ([appointmentId]):

$ curl -s -b cookies.txt "http://localhost:8080/api/schedule?doctorId=1&day=2030-01-15"
{
  "doctor":{"id":1,"version":0,"title":"Mme","firstName":"Marie","lastName":"PELISSIER"},
  "day":"2030-01-15",
  "slots":[
    {"id":1,"startHour":8,"startMinute":0,"endHour":8,"endMinute":20,"free":true,"patient":null,"mine":false,"bookable":true,"appointmentId":null},
    {"id":2,"startHour":8,"startMinute":20,"endHour":8,"endMinute":40,"free":true,"patient":null,"mine":false,"bookable":true,"appointmentId":null},
    {"id":3,"startHour":8,"startMinute":40,"endHour":9,"endMinute":0,"free":false,"patient":{"title":"Mme","firstName":"Alice","lastName":"DURAND"},"mine":false,"bookable":false,"appointmentId":2},
    {"id":4,"startHour":9,"startMinute":0,"endHour":9,"endMinute":20,"free":true,"patient":null,"mine":false,"bookable":true,"appointmentId":null},
    {"id":5,"startHour":9,"startMinute":20,"endHour":9,"endMinute":40,"free":true,"patient":null,"mine":false,"bookable":true,"appointmentId":null},
    {"id":6,"startHour":9,"startMinute":40,"endHour":10,"endMinute":0,"free":true,"patient":null,"mine":false,"bookable":true,"appointmentId":null},
    {"id":7,"startHour":10,"startMinute":0,"endHour":10,"endMinute":20,"free":true,"patient":null,"mine":false,"bookable":true,"appointmentId":null},
    {"id":8,"startHour":10,"startMinute":20,"endHour":10,"endMinute":40,"free":true,"patient":null,"mine":false,"bookable":true,"appointmentId":null},
    {"id":9,"startHour":10,"startMinute":40,"endHour":11,"endMinute":0,"free":true,"patient":null,"mine":false,"bookable":true,"appointmentId":null},
    {"id":10,"startHour":11,"startMinute":0,"endHour":11,"endMinute":20,"free":true,"patient":null,"mine":false,"bookable":true,"appointmentId":null},
    {"id":11,"startHour":11,"startMinute":20,"endHour":11,"endMinute":40,"free":true,"patient":null,"mine":false,"bookable":true,"appointmentId":null},
    {"id":12,"startHour":11,"startMinute":40,"endHour":12,"endMinute":0,"free":true,"patient":null,"mine":false,"bookable":true,"appointmentId":null}
  ],
  "info":null
}

Tente novamente: o paciente já tem uma consulta futura. Uma consulta no passado (15 de janeiro de 2020, arquivo [curl/appointment-past.json]) também é rejeitada:

1
2
3
4
5
6
$ curl -i -b cookies.txt --json @curl/appointment-admin.json http://localhost:8080/api/appointments
HTTP/1.1 409 Conflict
Content-Type: application/json; charset=utf-8
Content-Length: 66

{"statusCode":409,"key":"ERRORS.PATIENT_HAS_UPCOMING_APPOINTMENT"}
1
2
3
4
5
6
$ curl -i -b cookies.txt --json @curl/appointment-past.json http://localhost:8080/api/appointments
HTTP/1.1 409 Conflict
Content-Type: application/json; charset=utf-8
Content-Length: 43

{"statusCode":409,"key":"ERRORS.PAST_DATE"}

Um formulário HTML padrão (simulado aqui por [-d], que envia [application/x-www-form-urlencoded]) é rejeitado:

1
2
3
4
5
6
$ curl -i -b cookies.txt -d "day=2030-01-15&slotId=4&clientId=2" http://localhost:8080/api/appointments
HTTP/1.1 415 Unsupported Media Type
Content-Type: application/json; charset=utf-8
Content-Length: 47

{"statusCode":415,"key":"ERRORS.JSON_REQUIRED"}

8.6.4. A perspectiva de um paciente

Você faz logout e depois login como [martin]:

1
2
3
4
5
6
7
$ curl -i -b cookies.txt -c cookies.txt --json @curl/empty.json http://localhost:8080/api/auth/logout
HTTP/1.1 200 OK
Set-Cookie: rdvmedecins_jwt=; Path=/api; Expires=Thu, 01 Jan 1970 00:00:00 GMT
Content-Type: application/json; charset=utf-8
Content-Length: 2

{}
$ curl -s -c cookies-martin.txt --json @curl/login-martin.json http://localhost:8080/api/auth/login
{"login":"martin","name":"Jean MARTIN","role":"USER"}

A mesma agenda, vista por um paciente: o horário 3 está ocupado (["free":false]), mas ["patient"] é equivalente a [null]: o nome de Alice (DURAND) não foi enviado:

$ curl -s -b cookies-martin.txt "http://localhost:8080/api/schedule?doctorId=1&day=2030-01-15"
{
  "doctor":{"id":1,"version":0,"title":"Mme","firstName":"Marie","lastName":"PELISSIER"},
  "day":"2030-01-15",
  "slots":[
    {"id":1,"startHour":8,"startMinute":0,"endHour":8,"endMinute":20,"free":true,"patient":null,"mine":false,"bookable":true,"appointmentId":null},
    {"id":2,"startHour":8,"startMinute":20,"endHour":8,"endMinute":40,"free":true,"patient":null,"mine":false,"bookable":true,"appointmentId":null},
    {"id":3,"startHour":8,"startMinute":40,"endHour":9,"endMinute":0,"free":false,"patient":null,"mine":false,"bookable":false,"appointmentId":null},
    {"id":4,"startHour":9,"startMinute":0,"endHour":9,"endMinute":20,"free":true,"patient":null,"mine":false,"bookable":true,"appointmentId":null},
    {"id":5,"startHour":9,"startMinute":20,"endHour":9,"endMinute":40,"free":true,"patient":null,"mine":false,"bookable":true,"appointmentId":null},
    {"id":6,"startHour":9,"startMinute":40,"endHour":10,"endMinute":0,"free":true,"patient":null,"mine":false,"bookable":true,"appointmentId":null},
    {"id":7,"startHour":10,"startMinute":0,"endHour":10,"endMinute":20,"free":true,"patient":null,"mine":false,"bookable":true,"appointmentId":null},
    {"id":8,"startHour":10,"startMinute":20,"endHour":10,"endMinute":40,"free":true,"patient":null,"mine":false,"bookable":true,"appointmentId":null},
    {"id":9,"startHour":10,"startMinute":40,"endHour":11,"endMinute":0,"free":true,"patient":null,"mine":false,"bookable":true,"appointmentId":null},
    {"id":10,"startHour":11,"startMinute":0,"endHour":11,"endMinute":20,"free":true,"patient":null,"mine":false,"bookable":true,"appointmentId":null},
    {"id":11,"startHour":11,"startMinute":20,"endHour":11,"endMinute":40,"free":true,"patient":null,"mine":false,"bookable":true,"appointmentId":null},
    {"id":12,"startHour":11,"startMinute":40,"endHour":12,"endMinute":0,"free":true,"patient":null,"mine":false,"bookable":true,"appointmentId":null}
  ],
  "info":null
}

Um paciente não tem acesso à lista de clientes:

1
2
3
4
5
6
$ curl -i -b cookies-martin.txt http://localhost:8080/api/clients
HTTP/1.1 403 Forbidden
Content-Type: application/json; charset=utf-8
Content-Length: 43

{"statusCode":403,"key":"ERRORS.FORBIDDEN"}

Ele reserva para si mesmo (o registro, [curl/appointment-martin.json], não contém [clientId]), uma vez, não duas ([curl/appointment-martin-2.json]: no dia seguinte, horário 6):

{ "day": "2030-01-15", "slotId": 5 }
1
2
3
4
5
6
$ curl -i -b cookies-martin.txt --json @curl/appointment-martin.json http://localhost:8080/api/appointments
HTTP/1.1 201 Created
Content-Type: application/json; charset=utf-8
Content-Length: 51

{"id":3,"day":"2030-01-15","slotId":5,"clientId":1}
1
2
3
4
5
6
$ curl -i -b cookies-martin.txt --json @curl/appointment-martin-2.json http://localhost:8080/api/appointments
HTTP/1.1 409 Conflict
Content-Type: application/json; charset=utf-8
Content-Length: 55

{"statusCode":409,"key":"SCHEDULE.ALREADY_BOOKED_INFO"}

Sua área:

$ curl -s -b cookies-martin.txt http://localhost:8080/api/my-area
{
  "patient":{"title":"Mr","firstName":"Jean","lastName":"MARTIN"},
  "appointments":[
    {
      "id":3,
      "day":"2030-01-15",
      "slot":{"id":5,"startHour":9,"startMinute":20,"endHour":9,"endMinute":40},
      "doctor":{"id":1,"version":0,"title":"Mme","firstName":"Marie","lastName":"PELISSIER"}
    }
  ]
}

Ele não pode cancelar a consulta de outro paciente. O servidor responde com “não encontrado”, exatamente como faria para uma consulta que não existe: não revela nada sobre as consultas de outros pacientes:

1
2
3
4
5
6
$ curl -i -b cookies-martin.txt -X DELETE http://localhost:8080/api/appointments/2
HTTP/1.1 404 Not Found
Content-Type: application/json; charset=utf-8
Content-Length: 55

{"statusCode":404,"key":"ERRORS.APPOINTMENT_NOT_FOUND"}

A sua própria, sim:

1
2
3
4
5
6
$ curl -i -b cookies-martin.txt -X DELETE http://localhost:8080/api/appointments/3
HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
Content-Length: 2

{}

8.6.5. A perspectiva de um médico

A Dra. PELISSIER faz login:

$ curl -s -c cookies-pelissier.txt --json @curl/login-pelissier.json http://localhost:8080/api/auth/login
{"login":"pelissier","name":"Marie PELISSIER","role":"DOCTOR"}

Sem [doctorId], um médico logado recebe a SUA PRÓPRIA agenda, com todos os nomes (a consulta de [martin] acabou de ser cancelada: a consulta de Alice, DURAND, permanece):

$ curl -s -b cookies-pelissier.txt "http://localhost:8080/api/schedule?day=2030-01-15"
{
  "doctor":{"id":1,"version":0,"title":"Mme","firstName":"Marie","lastName":"PELISSIER"},
  "day":"2030-01-15",
  "slots":[
    {"id":1,"startHour":8,"startMinute":0,"endHour":8,"endMinute":20,"free":true,"patient":null,"mine":false,"bookable":true,"appointmentId":null},
    {"id":2,"startHour":8,"startMinute":20,"endHour":8,"endMinute":40,"free":true,"patient":null,"mine":false,"bookable":true,"appointmentId":null},
    {"id":3,"startHour":8,"startMinute":40,"endHour":9,"endMinute":0,"free":false,"patient":{"title":"Mme","firstName":"Alice","lastName":"DURAND"},"mine":false,"bookable":false,"appointmentId":2},
    {"id":4,"startHour":9,"startMinute":0,"endHour":9,"endMinute":20,"free":true,"patient":null,"mine":false,"bookable":true,"appointmentId":null},
    {"id":5,"startHour":9,"startMinute":20,"endHour":9,"endMinute":40,"free":true,"patient":null,"mine":false,"bookable":true,"appointmentId":null},
    {"id":6,"startHour":9,"startMinute":40,"endHour":10,"endMinute":0,"free":true,"patient":null,"mine":false,"bookable":true,"appointmentId":null},
    {"id":7,"startHour":10,"startMinute":0,"endHour":10,"endMinute":20,"free":true,"patient":null,"mine":false,"bookable":true,"appointmentId":null},
    {"id":8,"startHour":10,"startMinute":20,"endHour":10,"endMinute":40,"free":true,"patient":null,"mine":false,"bookable":true,"appointmentId":null},
    {"id":9,"startHour":10,"startMinute":40,"endHour":11,"endMinute":0,"free":true,"patient":null,"mine":false,"bookable":true,"appointmentId":null},
    {"id":10,"startHour":11,"startMinute":0,"endHour":11,"endMinute":20,"free":true,"patient":null,"mine":false,"bookable":true,"appointmentId":null},
    {"id":11,"startHour":11,"startMinute":20,"endHour":11,"endMinute":40,"free":true,"patient":null,"mine":false,"bookable":true,"appointmentId":null},
    {"id":12,"startHour":11,"startMinute":40,"endHour":12,"endMinute":0,"free":true,"patient":null,"mine":false,"bookable":true,"appointmentId":null}
  ],
  "info":null
}

Ele não gerencia médicos:

1
2
3
4
5
6
$ curl -i -b cookies-pelissier.txt --json @curl/doctor-add.json http://localhost:8080/api/doctors
HTTP/1.1 403 Forbidden
Content-Type: application/json; charset=utf-8
Content-Length: 43

{"statusCode":403,"key":"ERRORS.FORBIDDEN"}

8.6.6. Gerenciamento de médicos e clientes (ADMIN)

O ADMIN está se reconectando (ele havia se desconectado antes):

$ curl -s -c cookies.txt --json @curl/login-admin.json http://localhost:8080/api/auth/login
{"login":"admin","name":"Administrator","role":"ADMIN"}

Uma adição. Se o nome de usuário estiver ausente, o padrão é o nome em minúsculas; a senha é o nome de usuário ([curl/doctor-add.json]):

{ "title": "Mme", "firstName": "Claire", "lastName": "LEROY" }
1
2
3
4
5
6
$ curl -i -b cookies.txt --json @curl/doctor-add.json http://localhost:8080/api/doctors
HTTP/1.1 201 Created
Content-Type: application/json; charset=utf-8
Content-Length: 90

{"id":4,"version":1,"title":"Mme","firstName":"Claire","lastName":"LEROY","login":"leroy"}

Corpo inválido: a resposta lista o erro de cada campo ([curl/doctor-invalid.json]):

{ "title": "Dr", "firstName": "", "lastName": "A-LAST-NAME-FAR-TOO-LONG-FOR-THE-DB", "login": "Claire L" }
$ curl -i -b cookies.txt --json @curl/doctor-invalid.json http://localhost:8080/api/doctors
HTTP/1.1 400 Bad Request
Content-Type: application/json; charset=utf-8
Content-Length: 218

{
  "statusCode":400,
  "key":"ERRORS.INVALID_FORM",
  "params":{"min":"6"},
  "fields":{"login":"ERRORS.INVALID_LOGIN","title":"ERRORS.INVALID_TITLE","firstName":"ERRORS.FIRSTNAME_REQUIRED","lastName":"ERRORS.LASTNAME_TOO_LONG"}
}

Um homônimo (Sr. Paul TATOU, [curl/doctor-duplicate.json]): os dois campos afetados são sinalizados:

$ curl -i -b cookies.txt --json @curl/doctor-duplicate.json http://localhost:8080/api/doctors
HTTP/1.1 409 Conflict
Content-Type: application/json; charset=utf-8
Content-Length: 151

{
  "statusCode":409,
  "key":"ERRORS.DOCTOR_ALREADY_EXISTS",
  "fields":{"firstName":"ERRORS.DOCTOR_ALREADY_EXISTS","lastName":"ERRORS.DOCTOR_ALREADY_EXISTS"}
}

Uma modificação. [version] é a que foi lida junto com o registro (aqui 1, [curl/doctor-edit.json]):

{ "title": "Mme", "firstName": "Claire", "lastName": "LEROY-MARTIN", "version": 1 }
1
2
3
4
5
6
$ curl -i -b cookies.txt -X PUT --json @curl/doctor-edit.json http://localhost:8080/api/doctors/4
HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
Content-Length: 97

{"id":4,"version":2,"title":"Mme","firstName":"Claire","lastName":"LEROY-MARTIN","login":"leroy"}

O registro agora está na versão 2. Reenviar a mesma alteração (com a versão 1) sobrescreveria um registro que foi modificado nesse meio-tempo por outra pessoa: é isso que o bloqueio otimista impede:

1
2
3
4
5
6
$ curl -i -b cookies.txt -X PUT --json @curl/doctor-edit.json http://localhost:8080/api/doctors/4
HTTP/1.1 409 Conflict
Content-Type: application/json; charset=utf-8
Content-Length: 51

{"statusCode":409,"key":"ERRORS.CONCURRENT_UPDATE"}

Um médico com consultas não pode ser excluído; os outros podem:

1
2
3
4
5
6
$ curl -i -b cookies.txt -X DELETE http://localhost:8080/api/doctors/1
HTTP/1.1 409 Conflict
Content-Type: application/json; charset=utf-8
Content-Length: 57

{"statusCode":409,"key":"ERRORS.DOCTOR_HAS_APPOINTMENTS"}
1
2
3
4
5
6
$ curl -i -b cookies.txt -X DELETE http://localhost:8080/api/doctors/4
HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
Content-Length: 2

{}

8.6.7. Criação de uma conta

Sem um passe, é impossível:

1
2
3
4
5
6
$ curl -i --json @curl/registration.json http://localhost:8080/api/register
HTTP/1.1 403 Forbidden
Content-Type: application/json; charset=utf-8
Content-Length: 56

{"statusCode":403,"key":"ERRORS.CAPTCHA_BEFORE_ACCOUNT"}

Primeiro, você resolve um CAPTCHA ([curl/captcha-test.json]: [{ "captchaId": "-", "captcha": "test" }]); o servidor emite um token, válido por 15 minutos, em um cookie:

1
2
3
4
5
6
7
$ curl -i -c cookies-registration.txt --json @curl/captcha-test.json http://localhost:8080/api/register/access
HTTP/1.1 200 OK
Set-Cookie: rdvmedecins_registration=d2f6290a-b277-4785-9fd9-fada3be36087; Max-Age=900; Path=/api/register; Expires=Tue, 06 Oct 2026 12:27:16 GMT; HttpOnly; SameSite=Strict
Content-Type: application/json; charset=utf-8
Content-Length: 2

{}
$ curl -s -b cookies-registration.txt http://localhost:8080/api/register/access
{"valid":true}

A confirmação da senha deve ser idêntica ([curl/registration-confirmation.json]: “secret1”, depois “secret2”):

1
2
3
4
5
6
$ curl -i -b cookies-registration.txt --json @curl/registration-confirmation.json http://localhost:8080/api/register
HTTP/1.1 400 Bad Request
Content-Type: application/json; charset=utf-8
Content-Length: 98

{"statusCode":400,"key":"ERRORS.INVALID_FORM","fields":{"confirmation":"ERRORS.PASSWORDS_DIFFER"}}

O corpo correto ([curl/registration.json]):

{ "title": "Mme", "firstName": "Julie", "lastName": "BERNARD", "login": "jbernard", "password": "secret1", "confirmation": "secret1" }
1
2
3
4
5
6
7
$ curl -i -b cookies-registration.txt -c cookies-registration.txt --json @curl/registration.json http://localhost:8080/api/register
HTTP/1.1 201 Created
Set-Cookie: rdvmedecins_registration=; Path=/api/register; Expires=Thu, 01 Jan 1970 00:00:00 GMT
Content-Type: application/json; charset=utf-8
Content-Length: 20

{"login":"jbernard"}

O passe foi utilizado: ele não pode ser usado para criar uma segunda conta:

1
2
3
4
5
6
$ curl -i -b cookies-registration.txt --json @curl/registration.json http://localhost:8080/api/register
HTTP/1.1 403 Forbidden
Content-Type: application/json; charset=utf-8
Content-Length: 56

{"statusCode":403,"key":"ERRORS.CAPTCHA_BEFORE_ACCOUNT"}

8.6.8. Gerenciamento da sua conta

A nova paciente faz login e lê o seu registro:

$ curl -s -c cookies-jbernard.txt --json @curl/login-jbernard.json http://localhost:8080/api/auth/login
{"login":"jbernard","name":"Julie BERNARD","role":"USER"}
$ curl -s -b cookies-jbernard.txt http://localhost:8080/api/my-account
{"title":"Mme","firstName":"Julie","lastName":"BERNARD","login":"jbernard","version":1}

Uma alteração exige a senha atual. O servidor emite um novo token, que contém o novo nome ([curl/my-account.json]):

{ "title": "Mme", "firstName": "Julie", "lastName": "BERNARD-DUVAL", "login": "jbernard", "currentPassword": "secret1", "version": 1 }
1
2
3
4
5
6
7
$ curl -i -b cookies-jbernard.txt -c cookies-jbernard.txt -X PUT --json @curl/my-account.json http://localhost:8080/api/my-account
HTTP/1.1 200 OK
Set-Cookie: rdvmedecins_jwt=eyJhbGciOiJIUzI1NiIs...; Max-Age=7200; Path=/api; Expires=Tue, 06 Oct 2026 14:12:17 GMT; HttpOnly; SameSite=Strict
Content-Type: application/json; charset=utf-8
Content-Length: 63

{"login":"jbernard","name":"Julie BERNARD-DUVAL","role":"USER"}

A exclusão da conta ([curl/my-account-delete.json]: [{ "currentPassword": "secret1" }]) também exclui o cookie:

1
2
3
4
5
6
7
$ curl -i -b cookies-jbernard.txt -c cookies-jbernard.txt -X DELETE --json @curl/my-account-delete.json http://localhost:8080/api/my-account
HTTP/1.1 200 OK
Set-Cookie: rdvmedecins_jwt=; Path=/api; Expires=Thu, 01 Jan 1970 00:00:00 GMT
Content-Type: application/json; charset=utf-8
Content-Length: 2

{}
1
2
3
4
5
6
$ curl -i -b cookies-jbernard.txt http://localhost:8080/api/auth/me
HTTP/1.1 401 Unauthorized
Content-Type: application/json; charset=utf-8
Content-Length: 47

{"statusCode":401,"key":"ERRORS.AUTH_REQUIRED"}

8.6.9. Alguns erros

Uma rota desconhecida, um corpo que não é um JSON válido:

1
2
3
4
5
6
$ curl -i -b cookies-martin.txt http://localhost:8080/api/does-not-exist
HTTP/1.1 404 Not Found
Content-Type: application/json; charset=utf-8
Content-Length: 43

{"statusCode":404,"key":"ERRORS.NOT_FOUND"}
1
2
3
4
5
6
$ curl -i -b cookies.txt -H "Content-Type: application/json" -d "{not json" http://localhost:8080/api/appointments
HTTP/1.1 400 Bad Request
Content-Type: application/json; charset=utf-8
Content-Length: 45

{"statusCode":400,"key":"ERRORS.BAD_REQUEST"}

Já sabemos tudo o que precisamos saber sobre o servidor para escrever o nosso cliente.