/api/v1/profile/save/ 保存用户画像
在 Adapty Mail 中创建或更新用户画像。用户画像包含用户的电子邮件和属性， Adapty Mail 使用这些信息来识别收件人并构建市场细分。
通过稳定的 external_profile_id 标识每个用户。再次发送相同的 external_profile_id
将更新现有用户画像，而不会创建重复记录。
Request body
由您的应用或后端持有的用户稳定标识符。在多次请求中复用相同的值， 以便 Adapty Mail 将电子邮件、点击和购买关联到同一用户画像。 切勿使用匿名或按安装生成的标识符。
用户创建时间，采用 ISO 8601 格式（例如 "2026-06-01T10:30:00Z"）。
您可以在市场细分中使用此日期。
用户的电子邮件地址。Adapty Mail 将营销邮件投递至此地址。
用户的名字。
用户的姓氏。
用户的性别。
用户的出生日期，采用 ISO 8601 格式（例如 "1990-05-21"）。
用户所在国家/地区，采用两位大写字母的 ISO 3166-1 alpha-2 代码（例如 US）。
用户的商店地区，采用两位大写字母的 ISO 3166-1 alpha-2 代码（例如 US）。
附加到用户画像的任意键值对（字符串或数字类型的值）。可用于构建
市场细分——例如 plan、signup_source 或 trial_days。
用户所使用的平台，例如 iOS 或 Android。
设备型号，例如 iPhone15,2。
操作系统版本，例如 17.5。
用户的语言区域设置，例如 en-US。
用户的时区，例如 America/New_York。
用户正在运行的应用版本，例如 3.1.0。
Responses
用户画像保存成功。响应体为空对象。
Schema
Example
{}验证失败——必填字段缺失或无效。field_name 指示出错的字段。
Schema
标准错误响应。每次失败均返回包含此结构的 4XX 状态码。
错误的可读描述。
机器可读的错误标识符。
此错误对应的 HTTP 状态码。
导致错误的请求字段，若错误与特定字段无关则为 null。
Example
{
"errors": [
{
"message": "Field required",
"error_code": "base_error",
"status_code": 400,
"field_name": "email"
}
]
}缺少或无效的密钥 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
}
]
}