Apresentar Defesa

Utilize este endpoint para registrar defesa de um MED específico pelo id, com texto e anexos opcionais.

Ambientes Disponíveis

Produção

https://api.gateway.com.br

Endpoint

• Método: PUT
• Endpoint: /med/{id}/appeal
• Autenticação: Bearer token
• Content-Type: multipart/form-data

Path Params

Nome	Tipo	Obrigatório	Descrição	Validações
id	string (UUID v4)	Sim	Identificador do MED	Deve ser UUID v4 válido

Body (multipart/form-data)

Nome	Tipo	Obrigatório	Descrição	Validações
message	string	Não	Mensagem da defesa	Campo textual da defesa (AppealMedInput), entre 2 e 510 caracteres
files	file[]	Não	Arquivos de evidência	Enviar múltiplos arquivos com o mesmo campo files; extensões permitidas: .jpg, .jpeg, .png, .pdf, .txt, .xls, .xlsx, .ico

Exemplo de Requisição (com todos os campos)

cURL

curl --request PUT \
--url https://api.gateway.com.br/med/553e8400-e29b-41d4-a716-436251480000/appeal \
--header 'Authorization: Bearer seu-token-jwt' \
--form 'message=Anexamos comprovante de entrega e autenticação da compra.' \
--form 'files=@C:/evidencias/comprovante-entrega.pdf' \
--form 'files=@C:/evidencias/print-rastreio.png'

JavaScript

const formData = new FormData();
formData.append('message', 'Anexamos comprovante de entrega e autenticação da compra.');
formData.append('files', fileInput.files[0]);
formData.append('files', fileInput.files[1]);

const response = await fetch('https://api.gateway.com.br/med/553e8400-e29b-41d4-a716-436251480000/appeal', {
  method: 'PUT',
  headers: {
    'Authorization': 'Bearer seu-token-jwt'
  },
  body: formData
});

Resposta de Sucesso

Código	Descrição
201 Created	Defesa registrada com sucesso

ℹ️ Corpo da resposta

Este endpoint retorna 201 e não possui payload de resposta.

Possíveis Erros

Código	Descrição	Solução
400	Requisição inválida	Verifique o formato do multipart/form-data e o campo files
401	Credenciais inválidas	Verifique suas credenciais
403	Sem permissão/autorização	Contate o suporte
404	MED não encontrado	Verifique o id informado
422	Dados inválidos ou faltando	Verifique o conteúdo da defesa e arquivos enviados
500	Erro interno	Contate o suporte