/car/upload_assessment_image
1.接口描述
该 API 用于上传定损案件的图片。
- 图片要求:
- 格式为 JPG(JPEG),PNG
- 宽和高大于 128px,小于等于 6000px
- 小于等于 5 MB
请求方式
POST
请求 URL
https://cloudapi.deepfinch.com/car/upload_assessment_image
2.请求参数
字段 | 类型 | 必需 | 描述 |
---|---|---|---|
assessment_id | string | 是 | 图片所属的评估编号,由接口car/create_assessment 创建 |
shoot_timestamp | integer | 是 | 拍摄时间戳,单位秒 |
group | integer | 是 | 图片分组, 当前必须为0 |
type | integer | 是 | 图像分类: 1: 局部图 2: 细节图,当前必须为1 |
file | file | 否 | 图片文件 |
file_url | string | 否 | 图片URL |
extinfo | string | 是 | json字符串, 定损SDK抽帧返回结果 |
file
和file_url
参数必须二选一
extinfo 字段
字段 | 类型 | 说明 |
---|---|---|
video_id | string | 本次拍摄的视频ID |
frame_id | int | 本次拍摄的帧ID |
sampling_step | string | 影像帧类型, Car: 损伤部位远景照,Part: 损伤部位中景照,Scar: 损伤近景照 |
frame_id
升序排列后,帧类型应该为由近及远[Scar->Part->Car]或者由远及近[Car->Part->Scar] Car、Part的影像type填1,Scar的影像type填2
3.返回参数
字段 | 类型 | 说明 |
---|---|---|
request_id | string | 本次请求的id |
status | string | 返回状态,正常为 OK , 其他值表示失败,详见错误码 |
image_id | string | 存储在云端的图片id |
返回结果示例
{
"request_id": "TIDf7802c753b3048eb8524f2dc143b7a70",
"status": "OK",
"image_id": "8bf47ab6eda64476973cc5f5b6ebf"
}
4.错误码
状态码 | status 字段 |
说明 |
---|---|---|
400 |
INVALID_ARGUMENT | 请求参数错误 |
400 |
QUERY_FAILED | 查询失败 |
401 |
UNAUTHORIZED | 未授权或授权失败 |
401 |
KEY_EXPIRED | 账号过期 |
403 |
NO_PERMISSION | 无调用权限 |
403 |
OUT_OF_QUOTA | 调用次数超出限额 |
403 |
RATE_LIMIT_EXCEEDED | 调用频率超出限额 |
404 |
NOT_FOUND | 请求路径错误 |
500 |
INTERNAL_ERROR | 服务器内部错误 |
备注: 以上40X系列错误描述请参考reason
字段
输出样例
{
"status": "INVALID_ARGUMENT",
"reason": "must specify 'file' argument",
"request_id": "TID8bf47ab6eda64476973cc5f5b6ebf57e"
}