開發者發現 Android 接口 URL 末尾有 }&files= 參數,詢問具體含義。
這是業務層參數,含義完全由後端接口定義,前端無法推斷。必須查看後端接口文檔或直接詢問後端開發人員。
| 場景 | 參數含義 | 示例值 |
|---|---|---|
| 文件上傳 | 文件數據的 Base64 編碼、或文件 ID 列表、或簽名 | files=[base64data]、files=fileId1,fileId2 |
| 多文件提交 | 表單字段名對應的文件元數據 JSON | files=[{"name":"a.jpg","type":"image/jpeg","size":12345}] |
| 分片上傳 | 分片索引、總分片數、文件標識 | files={"chunk":1,"total":5,"fileId":"abc"} |
| 簽名驗證 | 請求參數簽名,防篡改 | files=hmac_sha256(...) |
| 舊版兼容 | 歷史版本保留的廢棄參數,實際忽略 | files= (空) |
files 參數值與業務操作files 參數是什麼格式、必傳嗎、有什麼業務含義?」@RequestParam("files") 或 MultipartFile// Retrofit 示例
@Multipart
@POST("upload")
Call uploadFiles(
@Part("files") RequestBody filesJson, // 或 List
@Part("otherParam") RequestBody other
);
// 若不確定格式,先傳空字符串或 null 測試
RequestBody emptyFiles = RequestBody.create(MediaType.parse("application/json"), "[]");
一句話:沒有文檔就問人,別在這裡猜謎。