提交申诉

使用此端点按 id 为指定的 MED 登记申诉，可附带说明文字与附件。

可用环境

生产环境

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

端点

• 方法：POST
• 端点：/med/{id}/appeal
• 认证方式：Bearer token
• Content-Type：multipart/form-data

路径参数

名称	类型	必填	说明	校验规则
id	string (UUID v4)	是	MED 的标识	必须为有效的 UUID v4

请求体（multipart/form-data）

名称	类型	必填	说明	校验规则
message	string	否	申诉说明	申诉的文字字段（AppealMedInput），长度在 2 到 1000 个字符之间
files	file[]	否	证据文件	多个文件使用同一个 files 字段提交；允许的扩展名：.jpg、.jpeg、.png、.pdf、.txt、.xls、.xlsx、.ico

请求示例（包含全部字段）

cURL

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

成功响应

状态码	说明
201 Created	申诉已成功登记

ℹ️ 响应体

此端点返回 201，没有响应体。

可能的错误

状态码	说明	处理方式
400	请求无效	请检查 multipart/form-data 的格式与 files 字段
401	凭据无效	请检查您的凭据
403	无权限或未授权	请联系技术支持
404	未找到 MED	请检查传入的 id
422	数据无效或缺失	请检查申诉内容与提交的文件
500	内部错误	请联系技术支持