問題描述
白描網頁端的 API 請求以開發人員工具導出網路活動的 .har 確認圖片上傳邏輯有變，導致該插件會出現以下錯誤。
錯誤訊息
{
"code": 0,
"data": {
"hash": "8591a..."
},
"msg": "图片上传出错，请强制刷新网页后重试"
}
問題原因分析
白描 Web 端的網路活動觀察：
| 項目 |
舊版 API |
新版 API |
| 圖片傳輸方式 |
dataUrl (base64 直傳) |
先上傳至阿里雲 OSS，再傳 fileKey |
| 權限請求 |
/api/perm/single (mode only) |
/api/perm/single (需加 version: "v2") |
| Hash 計算 |
SHA1 of data:image/png;base64,... |
MD5 of 圖片二進位內容 |
| OCR 請求欄位 |
dataUrl, batchId, total |
fileKey, createdAt, size |
新版 API 流程
- 取得 OCR 權限 -
POST /api/perm/single (需 version: "v2")
- 取得 OSS 上傳簽名 -
GET /api/oss/sign?mime_type=...
- 上傳圖片至阿里雲 OSS -
POST {ossData.host} (multipart/form-data)
- 呼叫 OCR API -
POST /api/ocr/image/{engine} (帶 fileKey)
- 輪詢結果 -
GET /api/ocr/image/{engine}/status
問題描述
白描網頁端的 API 請求以開發人員工具導出網路活動的
.har確認圖片上傳邏輯有變，導致該插件會出現以下錯誤。錯誤訊息
{ "code": 0, "data": { "hash": "8591a..." }, "msg": "图片上传出错，请强制刷新网页后重试" }問題原因分析
白描 Web 端的網路活動觀察：
dataUrl(base64 直傳)fileKey/api/perm/single(mode only)/api/perm/single(需加version: "v2")data:image/png;base64,...dataUrl,batchId,totalfileKey,createdAt,size新版 API 流程
POST /api/perm/single(需version: "v2")GET /api/oss/sign?mime_type=...POST {ossData.host}(multipart/form-data)POST /api/ocr/image/{engine}(帶fileKey)GET /api/ocr/image/{engine}/status