Presentar Defensa

Utilice este endpoint para registrar la defensa de un MED específico por su id, con texto y adjuntos opcionales.

Entornos Disponibles

Producción

https://api.gateway.com.br/core

Endpoint

• Método: POST
• Endpoint: /med/{id}/appeal
• Autenticación: Bearer token
• Content-Type: multipart/form-data

Path Params

Nombre	Tipo	Obligatorio	Descripción	Validaciones
id	string (UUID v4)	Sí	Identificador del MED	Debe ser un UUID v4 válido

Body (multipart/form-data)

Nombre	Tipo	Obligatorio	Descripción	Validaciones
message	string	No	Mensaje de la defensa	Campo de texto de la defensa (AppealMedInput), entre 2 y 1000 caracteres
files	file[]	No	Archivos de evidencia	Envíe varios archivos bajo el mismo campo files; extensiones permitidas: .jpg, .jpeg, .png, .pdf, .txt, .xls, .xlsx, .ico

Ejemplo de Solicitud (con todos los campos)

cURL

curl --request POST \
--url https://api.gateway.com.br/core/med/553e8400-e29b-41d4-a716-436251480000/appeal \
--header 'Authorization: Bearer su-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/core/med/553e8400-e29b-41d4-a716-436251480000/appeal', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer su-token-jwt'
  },
  body: formData
});

Respuesta Exitosa

Código	Descripción
201 Created	Defensa registrada con éxito

ℹ️ Cuerpo de la respuesta

Este endpoint devuelve 201 y no tiene payload de respuesta.

Errores Posibles

Código	Descripción	Solución
400	Solicitud inválida	Verifique el formato del multipart/form-data y el campo files
401	Credenciales inválidas	Verifique sus credenciales
403	Sin permiso/autorización	Contacte al soporte
404	MED no encontrado	Verifique el id enviado
422	Datos inválidos o faltantes	Verifique el contenido de la defensa y los archivos enviados
500	Error interno	Contacte al soporte