文档管理中心
API参考运动健康服务基础能力服务 API 参考REST采样数据集接口删除时间段内的采样数据集

删除时间段内的采样数据集

功能介绍

删除指定时间段内的采样数据集。

场景描述

指定开始时间和结束时间,删除指定采集器在该时间段内的采样数据点。

使用约束

  • 只允许创建该数据采集器的应用删除该数据采集器的采样数据,其他应用只支持读取该数据采集器的数据。
  • 超级应用的derived数据不允许删除。

接口原型

承载协议

HTTPS DELETE

接口方向

开发者应用->Health Service Kit云

接口URL

https://health-api.cloud.huawei.com/healthkit/v2/dataCollectors/{dataCollectorId}/sampleSets/{sampleSetId}

数据格式

请求消息:Content-Type: application/json

响应消息:Content-Type: application/json

路径参数

展开

参数

参数类型

是否必选

描述

dataCollectorId

String

数据采集器的唯一标识。

sampleSetId

String

采样数据集标识符。单位:纳秒

格式:“startTime-endTime”,其中:startTime/endTime必须是19位整数的时间戳。

对应时间范围是2000-01-01 00:00:00 ~ 2099-12-31 23:59:59。

请求参数

Request Header

展开

参数

参数类型

是否必选

描述

Content-type

String

取值为:application/json; charset=UTF-8

Authorization

String

请参见认证鉴权

说明

Bearer后面拼接空格,再拼接获取的access_token。

x-client-id

String

开放联盟分配的应用标识。服务端可以基于其进行灰度路由,建议携带。

x-version

String

接口调用方的软件版本号。即当前客户端版本号,服务端可以基于其进行灰度,建议携带。

x-caller-trace-id

String

请求跟踪ID。用于串联服务调用方与服务端整体请求链条,建议携带。

Request Body

请求示例

DELETE
https://health-api.cloud.huawei.com/healthkit/v2/dataCollectors/cmF3OmNvbnRpbnVvdXMuY2Fsb3JpZXMuYnVybnQEwMTI3ODUwMTpqEF7rB3uBcGykpv6T2TisfTMhfZAvz1BP2Kcz70d1Sg/sampleSets/1567267200000000000-1567440000000000000
Content-Type: application/json
Authorization: Bearer ***
x-client-id: ***
x-version: ***
x-caller-trace-id: ***

响应参数

状态码为204时:

Response Header

展开

参数

参数类型

是否必选

描述

Content-Type

String

取值为:application/json; charset=UTF-8

Response Body

响应示例

HTTP 204 No Content

错误码

请参见错误码

在 API参考 中进行搜索
请输入您想要搜索的关键词