/api/v1/profile/delete/ 删除用户画像
清除用户画像的个人数据并取消其计划中的邮件。用于履行数据删除权请求。
通过 external_profile_id、customer_user_id 或 email 识别用户画像——至少提供其中一个。Adapty Mail 通过电子邮件地址匹配用户,因此您发送的 email 是唯一尝试的标识符;省略它则通过 external_profile_id 或 customer_user_id 查找用户画像。
删除操作会清除已存储的数据,但不会屏蔽该地址。后续的 保存用户画像 请求将创建新的用户画像,不包含已删除用户画像的任何历史记录。若要永久排除某人,请停止发送其数据。
通过 external_profile_id 或 customer_user_id 重复删除操作会再次成功,但不会做任何更改。仅通过 email 重复删除操作则返回 404:因为清除操作已删除存储的地址,email 已无任何内容可匹配。
Request body
要删除的用户画像标识符。请至少提供 external_profile_id、
customer_user_id 或 email 之一。
保存用户画像时您所发送的标识符。
用户在您自有系统中的标识符。
用户画像中的电子邮件地址。
Responses
用户画像已删除。响应无正文。
未提供任何标识符。
Schema
标准错误响应。每次失败都会返回一个包含此结构的 4XX 状态。
人类可读的错误描述。
机器可读的错误标识符。
此错误的 HTTP 状态码。
导致错误的请求字段,如果错误与字段无关则为 null。
Example
{
"errors": [
{
"message": "At least one of external_profile_id, customer_user_id or email must be provided",
"error_code": "missing_identifier",
"status_code": 400,
"field_name": null
}
]
} Secret API 密钥缺失或无效。
Schema
标准错误响应。每次失败都会返回一个包含此结构的 4XX 状态。
人类可读的错误描述。
机器可读的错误标识符。
此错误的 HTTP 状态码。
导致错误的请求字段,如果错误与字段无关则为 null。
Example
{
"errors": [
{
"message": "Secret key doesn't exist",
"error_code": "secret_key_does_not_exist_error",
"status_code": 403,
"field_name": null
}
]
} 未找到与您发送的标识符匹配的用户画像。
Schema
标准错误响应。每次失败都会返回一个包含此结构的 4XX 状态。
人类可读的错误描述。
机器可读的错误标识符。
此错误的 HTTP 状态码。
导致错误的请求字段,如果错误与字段无关则为 null。
Example
{
"errors": [
{
"message": "Profile not found",
"error_code": "profile_not_found_error",
"status_code": 404,
"field_name": null
}
]
}