固定接口
所有项目共用;taskid 只会在成功扣点或专项成功的识别响应中返回,有效期 60 秒。
| 接口 | 方式 | 地址 | 参数 | 返回 | 说明 |
|---|---|---|---|---|---|
| 识别提交 | POST | https://api.tmocr.com/post | appkey、itemid、本项目参数 | success、code、message、data、time、taskid | time 为服务端耗时;成功扣点或专项成功响应返回 taskid。 |
| 余额查询 | POST | https://api.tmocr.com/balance | appkey | success、code、message、data、time | 按 appkey 查询可用点数及其折算余额。 |
| 结果错误上报 | POST | https://api.tmocr.com/report | appkey、taskid、reason(可选) | success、code、message、data、time | 成功响应后 60 秒内提交;重复提交不会重复退点。 |
请求参数
| 参数 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
| appkey | string | 必填 | 用户密钥。 | YOUR_APPKEY |
| itemid | string | 必填 | 项目 ID。 | 1007 |
| developerKey | string | 选填 | 开发者标识,选填。 | YOUR_DEVELOPER_KEY |
| main | base64 string | 必填 | 主图 base64。 | BASE64_IMAGE_DATA |
对接接口
| 对接地址 | https://api.tmocr.com/post |
|---|---|
| 请求方式 | POST |
| 内容类型 | JSON / 表单 / multipart |
| 项目 ID | 1007 |
| 响应格式 | JSON |
| 在线测试 | 登录后可用 |
在线测试
可测试
登录后可直接上传图片进行扣费测试。登录后测试
测试参数
ItemID 1007
主图
base64 string
必填
主图 base64。
上传后会在这里显示图片预览。
请求 JSON
{
"appkey": "LOGIN_REQUIRED",
"itemid": "1007",
"main": ""
}结果图片标注
坐标、点位、框选或滑块位移结果会叠加在本次上传的图片上。
当前响应没有可叠加的坐标或框选结果
返回值已保留,当前项目结果更适合文本或表格查看。
当前记录没有可展示的公开结果。
JSON 实际结果
{
"message": "提交测试后显示实际返回结果。"
}代码示例
按语言复制调用示例。
curl -X POST "https://api.tmocr.com/post" \
-H "Content-Type: application/json" \
-d '{
"appkey": "YOUR_APPKEY",
"itemid": "1007",
"developerKey": "YOUR_DEVELOPER_KEY",
"main": "BASE64_IMAGE_DATA"
}'余额查询示例
按 appkey 查询可用点数及折算余额。
curl -X POST "https://api.tmocr.com/balance" \
-H "Content-Type: application/json" \
-d '{
"appkey": "YOUR_APPKEY"
}'结果错误上报示例
仅成功扣点响应会返回 taskid;如结果不正确,可在 60 秒内上报。
curl -X POST "https://api.tmocr.com/report" \
-H "Content-Type: application/json" \
-d '{
"appkey": "YOUR_APPKEY",
"taskid": "TXAbCdEfGhIjKl",
"reason": "识别结果不正确"
}'响应示例
平台响应格式示例。
成功响应
HTTP 200
{
"success": true,
"code": "OK",
"message": "识别成功",
"data": "[[0, 48, 120, 168], [120, 48, 240, 168], [240, 48, 360, 168], [120, 168, 240, 288]]",
"time": "123ms",
"taskid": "TXAbCdEfGhIjKl"
}失败响应
回放方式:故意省略必填字段 `main`
HTTP 400
{
"success": false,
"code": "RECOGNITION_FAILED",
"message": "Missing parameters [image, file]",
"data": "",
"time": "8ms"
}