沙特协作

    文件上传

    接口

    POST /upload?sessionId=<sessionId>

    说明

    上传截图或其他文件，服务端进行 OCR 识别（可选）。

    请求体

    multipart/form-data：

    字段类型必填说明
    screenshotfile是图片文件（支持 jpg/png/gif）

    响应示例

    {
  "code": "0",
  "success": true,
  "numbers": ["SF1234567890", "YT9876543210"],
  "count": 2
}

    字段说明

    字段类型说明
    codestring状态码，"0" 表示成功
    successboolean是否成功
    numbersstring[]识别到的运单号/条码列表
    countnumber识别到的数量

    使用场景

    • 上传截图自动 OCR 识别运单号、条码
    • 批量导入物流单号到二维码卡片

    示例

    cURL

    curl -X POST 'https://shater.online/upload?sessionId=7a58592c72f04fe' \
  -F 'screenshot=@/path/to/screenshot.jpg'

    JavaScript

    const formData = new FormData();
formData.append('screenshot', fileInput.files[0]);

const response = await fetch(`${UPLOAD_URL}?sessionId=${SESSION_ID}`, {
  method: 'POST',
  body: formData,
});

const result = await response.json();
console.log('识别到', result.count, '个条码：', result.numbers);

    相关文档