目录

删除个人数据

功能介绍

终端用户在应用客户端发起个人数据删除请求,应用服务端调用此接口能够协助用户删除在分析服务平台的数据。

场景描述

当您需要支持终端用户删除个人数据,以满足GDPR要求时,您可以在其开发的应用中提供删除个人数据按钮,当终端用户点击此按钮时,您的应用服务器可以调用此接口删除其采集上报到Analytics Kit服务端的该用户的数据。

使用约束

接口原型

承载协议

HTTP POST

接口方向

开发者回调接口服务器->分析服务服务器

接口URL

{rootUrl}/analytics/gdpr/user_deletion_requests/v2

说明:

{rootUrl}:请参见接口访问路径获取。

数据格式

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

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

请求参数

Request Header

参数

是否必选

参数类型

描述

x-product-id

是

String

用户在AppGallery Connect上的Product ID。

x-app-id

是

String

用户在AppGallery Connect上的App ID。

Authorization

是

String

鉴权信息。请参见基于OAuth 2.0开放鉴权。

说明:

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

Request Body

参数

是否必选

参数类型

描述

aaid

否

String

通过HMS Core端侧接口获取。

请求示例

POST /analytics/gdpr/user_deletion_requests/v2 HTTP/1.1
Content-Type: application/json; charset=UTF-8
Content-Length: xxxx
Accept: application/json
Authorization: Bearer *** 
x-product-id: sample-productid
x-app-id: sample-appid
 
{
     "aaid":"sample-aaid"
}

响应参数

状态码为200时:

Response Header

参数

是否必选

参数类型

描述

Content-Type

是

application/json

响应消息的数据格式。

Response Body

参数

是否必选

参数类型

描述

result_code

是

String

响应码,请参见错误码。

result_msg

是

String

响应描述。

响应示例

状态码为200时:

HTTP/1.1 200 OK
Content-Type: application/json; charset=UTF-8
Connection:  Close
Content-Length: xxxx                       
 
{
  "result_code":"0",
  "result_msg":"success"
}

错误码

状态码

错误码

描述

解决方法

200

0

请求成功。

-

400

10020

非法参数。

请修改填写错误的参数值。

400

10032

数据导出中,无法删除。

请提示用户,正在导出该用户的个人数据,需要待导出完成后,重新申请删除数据。

400

10033

数据已删除。

请提示用户数据已经删除。

400

10008

接口请求过于频繁。

请提示用户请求删除数据过于频繁,稍后再试。

Postman调试

您可以使用Postman在线调试此接口。