上报刷牙报告（优化得分后）

POST

https://test.myusmile.online/user/brushRecord/saveRecord/v3

请求参数

Header 参数

TOK

string

可选

默认值:

Body 参数application/json

data

array [object {47}]

必需

integer

主键ID

可选

updateTimestamp

integer

数据版本号（毫秒时间戳)

可选

userId

string

用户usmid

可选

deviceId

string

牙刷硬件码

必需

uploadDeviceSN

string

数据上传终端标识，当前为中控sn

可选

pattern

string

刷牙模式

可选

strengthLevel

string

刷牙档位

可选

standardDuration

integer

刷牙标准时长默认2min

可选

actualDuration

integer

本次刷牙时长

可选

createTime

string

时间戳,秒

必需

repairBrush

enum<integer>

0:不需要补刷，1：需要补刷，2：已完成补刷

可选

枚举值:

012

durationScore

integer

刷牙时间分数

可选

zoneDurationScore

integer

分区刷牙时间分数

可选

coverage

integer

覆盖率

可选

coverageScore

integer

覆盖率评分

可选

headUsedDayScore

integer

刷头使用天数评分

可选

poseErrorCount

integer

姿势错误次数

可选

overpressCount

integer

过压次数

可选

score

integer

本次刷牙评分

可选

plaqueResiduePercent

integer

牙菌斑残留百分比

可选

totalArea

integer

总区域数

可选

totalSurface

integer

总面数

可选

remindReport

string

所有异常提醒统计

可选

surfaceCoverReport

string

各个面的刷牙覆盖时长

可选

leftDown

string

左下区评分

可选

centerDown

string

中下区评分

可选

rightDown

string

右下区评分

可选

leftUp

string

左上区评分

可选

centerUp

string

中上区评分

可选

rightUp

string

右上区评分

可选

dayTime

string

刷牙日期

可选

pressureScore

integer

压力感应评分

可选

strengthValue

integer

压力感应百分比

可选

deleteStatus

enum<integer>

删除状态

可选

枚举值:

metaData

string

扩展字段

可选

timeType

enum<string>

时间类型

可选

枚举值:

paramSwitch

string

全口参数开关

可选

timeHb

integer

全口横刷时长

可选

factorSwitch

string

区域牙膜开关

可选

vecTimeDisplay

string

区域刷牙时长呈现百分比

可选

vecTimeOpDisplay

string

区域过压时长呈现百分比

可选

vecTimeHbDisplay

string

区域横刷时长呈现百分比

可选

vecCoverage

string

区域覆盖率

可选

otherData

string

可选

algoVer

integer

算法版本号

可选

protocolVer

integer

协议版本号

可选

timestampEnd

integer

刷牙结束时间

可选

示例

{
    "data": [
        {
            "id": 0,
            "updateTimestamp": 0,
            "userId": "string",
            "deviceId": "string",
            "uploadDeviceSN": "string",
            "pattern": "string",
            "strengthLevel": "string",
            "standardDuration": 0,
            "actualDuration": 0,
            "createTime": "string",
            "repairBrush": 0,
            "durationScore": 0,
            "zoneDurationScore": 0,
            "coverage": 0,
            "coverageScore": 0,
            "headUsedDayScore": 0,
            "poseErrorCount": 0,
            "overpressCount": 0,
            "score": 0,
            "plaqueResiduePercent": 0,
            "totalArea": 0,
            "totalSurface": 0,
            "remindReport": "string",
            "surfaceCoverReport": "string",
            "leftDown": "string",
            "centerDown": "string",
            "rightDown": "string",
            "leftUp": "string",
            "centerUp": "string",
            "rightUp": "string",
            "dayTime": "string",
            "pressureScore": 0,
            "strengthValue": 0,
            "deleteStatus": 0,
            "metaData": "string",
            "timeType": "1",
            "paramSwitch": "string",
            "timeHb": 0,
            "factorSwitch": "string",
            "vecTimeDisplay": "string",
            "vecTimeOpDisplay": "string",
            "vecTimeHbDisplay": "string",
            "vecCoverage": "string",
            "otherData": "string",
            "algoVer": 0,
            "protocolVer": 0,
            "timestampEnd": 0
        }
    ]
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://test.myusmile.online/user/brushRecord/saveRecord/v3' \
--header 'TOK: ' \
--header 'Content-Type: application/json' \
--data-raw '{
    "data": [
        {
            "id": 0,
            "updateTimestamp": 0,
            "userId": "string",
            "deviceId": "string",
            "uploadDeviceSN": "string",
            "pattern": "string",
            "strengthLevel": "string",
            "standardDuration": 0,
            "actualDuration": 0,
            "createTime": "string",
            "repairBrush": 0,
            "durationScore": 0,
            "zoneDurationScore": 0,
            "coverage": 0,
            "coverageScore": 0,
            "headUsedDayScore": 0,
            "poseErrorCount": 0,
            "overpressCount": 0,
            "score": 0,
            "plaqueResiduePercent": 0,
            "totalArea": 0,
            "totalSurface": 0,
            "remindReport": "string",
            "surfaceCoverReport": "string",
            "leftDown": "string",
            "centerDown": "string",
            "rightDown": "string",
            "leftUp": "string",
            "centerUp": "string",
            "rightUp": "string",
            "dayTime": "string",
            "pressureScore": 0,
            "strengthValue": 0,
            "deleteStatus": 0,
            "metaData": "string",
            "timeType": "1",
            "paramSwitch": "string",
            "timeHb": 0,
            "factorSwitch": "string",
            "vecTimeDisplay": "string",
            "vecTimeOpDisplay": "string",
            "vecTimeHbDisplay": "string",
            "vecCoverage": "string",
            "otherData": "string",
            "algoVer": 0,
            "protocolVer": 0,
            "timestampEnd": 0
        }
    ]
}'

返回响应

🟢200成功

application/json

Body

flag

boolean

必需

code

integer

必需

message

string

必需

desc

string

可选

data

array [object {8}] | null

必需

integer

必需

updateTimestamp

integer

必需

deviceId

string

必需

createTime

string

必需

habitBrushTime

string | null

必需

habitCoverageRate

string | null

必需

cariesRate

string | null

必需

cariesRateAlgo

integer | null

必需

示例

成功示例异常示例

{
    "flag": true,
    "code": 20000,
    "message": "save succeed",
    "data": [
        {
            "id": 678856,
            "updateTimestamp": 1713752986978,
            "deviceId": "74:4d:bd:95:7c:22",
            "createTime": "1713520717",
            "habitBrushTime": null,
            "habitCoverageRate": null,
            "cariesRate": null,
            "cariesRateAlgo": null
        }
    ]
}

删除刷牙报告（根据id-当前app正在使用）

获取比请求版本号（毫秒时间戳）更高的版本号列表