ÿÿ LÆ°u hồ sÆ¡ ngÆ°á»i dùng (API)
English 中文TürkçeРуÑÑкийEspañol日本語Tiếng Việt
POST /api/v1/profile/save/

LÆ°u hồ sÆ¡ ngÆ°á»i dùng

Copy as Markdown

Tạo hoặc cập nhật má»™t hồ sÆ¡ ngÆ°á»i dùng trong Adapty Mail. Hồ sÆ¡ ngÆ°á»i dùng mang theo email và các thuá»™c tính mà Adapty Mail sá»­ dụng để xác định ngÆ°á»i nhận và xây dá»±ng phân khúc.

Xác định từng ngÆ°á»i dùng bằng má»™t external_profile_id ổn định. Gá»­i cùng má»™t external_profile_id lần nữa sẽ cập nhật hồ sÆ¡ hiện có thay vì tạo bản trùng lặp.

Request body

external_profile_idstringrequired

Mã định danh ổn định cho ngÆ°á»i dùng, do ứng dụng hoặc backend của bạn quản lý. Sá»­ dụng lại cùng má»™t giá trị trong các yêu cầu để Adapty Mail liên kết email, lượt nhấp và giao dịch mua vá»›i má»™t hồ sÆ¡ duy nhất. Không bao giá» sá»­ dụng mã định danh ẩn danh hoặc mã định danh theo từng lần cài đặt.

external_created_atstringrequired

Thá»i gian tạo ngÆ°á»i dùng, theo định dạng ISO 8601 (ví dụ: "2026-06-01T10:30:00Z"). Bạn có thể sá»­ dụng ngày này trong các phân khúc.

emailstringrequired

Äịa chỉ email của ngÆ°á»i dùng. Adapty Mail gá»­i các chiến dịch đến địa chỉ này.

first_namestring

Tên của ngÆ°á»i dùng.

last_namestring

Há» của ngÆ°á»i dùng.

genderstring

Giá»›i tính của ngÆ°á»i dùng.

birthdaystring

Ngày sinh của ngÆ°á»i dùng, theo định dạng ISO 8601 (ví dụ: "1990-05-21").

countrystring

Quốc gia của ngÆ°á»i dùng dÆ°á»›i dạng mã ISO 3166-1 alpha-2 viết hoa gồm hai chữ cái (ví dụ: US).

store_countrystring

Khu vá»±c cá»­a hàng của ngÆ°á»i dùng dÆ°á»›i dạng mã ISO 3166-1 alpha-2 viết hoa gồm hai chữ cái (ví dụ: US).

custom_attributesobject

Các cặp key-value tùy ý (giá trị chuá»—i hoặc số) để đính kèm vào hồ sÆ¡ ngÆ°á»i dùng. Sá»­ dụng chúng để xây dá»±ng phân khúc — ví dụ: plan, signup_source hoặc trial_days.

device_infoobject
platformstringrequired

Ná»n tảng mà ngÆ°á»i dùng Ä‘ang sá»­ dụng, ví dụ: iOS hoặc Android.

devicestring

Kiểu thiết bị, ví dụ: iPhone15,2.

osstring

Phiên bản hệ Ä‘iá»u hành, ví dụ: 17.5.

localestring

Ngôn ngữ và vùng của ngÆ°á»i dùng, ví dụ: en-US.

timezonestring

Múi giá» của ngÆ°á»i dùng, ví dụ: America/New_York.

app_versionstring

Phiên bản ứng dụng của bạn mà ngÆ°á»i dùng Ä‘ang chạy, ví dụ: 3.1.0.

Responses

Hồ sÆ¡ ngÆ°á»i dùng đã được lÆ°u thành công. Ná»™i dung phản hồi là má»™t đối tượng rá»—ng.

Schema
object
Example 
{}

Xác thá»±c thất bại — má»™t trÆ°á»ng bắt buá»™c bị thiếu hoặc không hợp lệ. field_name cho biết trÆ°á»ng nào.

Schema

Phản hồi lá»—i chuẩn. Má»i lá»—i Ä‘á»u trả vá» trạng thái 4XX vá»›i cấu trúc này.

errorsarray of object
messagestring

Mô tả lá»—i dá»… Ä‘á»c cho ngÆ°á»i dùng.

error_codestring

Mã định danh lá»—i dá»… Ä‘á»c cho máy.

status_codeinteger

Mã trạng thái HTTP cho lỗi này.

field_namestring

TrÆ°á»ng trong yêu cầu gây ra lá»—i, hoặc null nếu lá»—i không liên quan đến trÆ°á»ng cụ thể nào.

Example 
{
  "errors": [
    {
      "message": "Field required",
      "error_code": "base_error",
      "status_code": 400,
      "field_name": "email"
    }
  ]
}

Thiếu hoặc sai secret API key.

Schema

Phản hồi lá»—i chuẩn. Má»i lá»—i Ä‘á»u trả vá» trạng thái 4XX vá»›i cấu trúc này.

errorsarray of object
messagestring

Mô tả lá»—i dá»… Ä‘á»c cho ngÆ°á»i dùng.

error_codestring

Mã định danh lá»—i dá»… Ä‘á»c cho máy.

status_codeinteger

Mã trạng thái HTTP cho lỗi này.

field_namestring

TrÆ°á»ng trong yêu cầu gây ra lá»—i, hoặc null nếu lá»—i không liên quan đến trÆ°á»ng cụ thể nào.

Example 
{
  "errors": [
    {
      "message": "Secret key doesn't exist",
      "error_code": "secret_key_does_not_exist_error",
      "status_code": 403,
      "field_name": null
    }
  ]
}
ÿÿÿÿ