/api/v2/server-side-api/profile/ Lấy hồ sơ người dùng
Truy xuất thông tin chi tiết của một người dùng cuối hiện có trong ứng dụng của bạn.
Header parameters
ID duy nhất của khách hàng trong hệ thống của bạn. Cần cung cấp một trong hai giá trị adapty-customer-user-id hoặc adapty-profile-id.
ID duy nhất của hồ sơ người dùng trong hệ thống của bạn. Lựa chọn tốt nhất khi làm việc với các hồ sơ người dùng ẩn danh. Cần cung cấp một trong hai giá trị adapty-customer-user-id hoặc adapty-profile-id.
Responses
Lấy hồ sơ người dùng thành công
Schema
ID nội bộ của ứng dụng của bạn
ID hồ sơ người dùng Adapty
ID của người dùng trong hệ thống của bạn
Giá trị số thực đại diện cho tổng doanh thu tính bằng USD thu được trong hồ sơ người dùng
Tham số nội bộ
Thời gian phản hồi tính bằng mili giây, dùng để giải quyết race condition
Tối đa 30 thuộc tính tùy chỉnh được phép thiết lập cho hồ sơ người dùng
Khóa phải là một chuỗi không quá 30 ký tự. Chỉ cho phép các chữ cái, số, dấu gạch ngang, dấu chấm và dấu gạch dưới
Giá trị thuộc tính không được vượt quá 50 ký tự. Chỉ cho phép chuỗi và số thực (float) làm giá trị
Mảng các đối tượng mức độ truy cập. Mảng rỗng nếu khách hàng không có mức độ truy cập nào
Mã định danh mức độ truy cập
Cửa hàng nơi mức độ truy cập được mua
ID sản phẩm trong cửa hàng
ID gói cơ bản trong cửa hàng
ID giao dịch trong cửa hàng
ID giao dịch gốc trong cửa hàng
Chi tiết ưu đãi, nếu có ưu đãi hoặc ưu đãi giới thiệu được áp dụng
Danh mục ưu đãi
One of: "introductory", "promotional", "offer_code", "win_back"
Loại ưu đãi
One of: "free_trial", "pay_as_you_go", "pay_up_front"
ID ưu đãi
Thời điểm mức độ truy cập bắt đầu
Thời điểm mức độ truy cập được mua
Thời điểm mức độ truy cập được mua lần đầu
Thời điểm mức độ truy cập hết hạn
Thời điểm gia hạn bị hủy
Thời điểm phát hiện sự cố thanh toán
Mức độ truy cập có đang trong thời gian ân hạn hay không
Lý do hủy
Mảng các đối tượng gói đăng ký. Mảng rỗng nếu khách hàng không có gói đăng ký nào
Cửa hàng nơi gói đăng ký được mua
ID sản phẩm trong cửa hàng
ID gói cơ bản trong cửa hàng
ID giao dịch trong cửa hàng
ID giao dịch gốc trong cửa hàng
Chi tiết ưu đãi, nếu có ưu đãi hoặc ưu đãi giới thiệu được áp dụng
Danh mục ưu đãi
One of: "introductory", "promotional", "offer_code", "win_back"
Loại ưu đãi
One of: "free_trial", "pay_as_you_go", "pay_up_front"
ID ưu đãi
Môi trường (Sandbox, Production)
Thời điểm gói đăng ký được mua
Thời điểm gói đăng ký được mua lần đầu
Thời điểm gói đăng ký hết hạn
Thời điểm hủy gia hạn
Thời điểm phát hiện sự cố thanh toán
Gói đăng ký có đang trong thời gian ân hạn hay không
Lý do hủy
Mảng các đối tượng sản phẩm mua một lần. Mảng rỗng nếu khách hàng chưa thực hiện giao dịch mua nào
Mã định danh mua hàng duy nhất
Cửa hàng nơi thực hiện giao dịch mua
ID sản phẩm trong cửa hàng
ID gói cơ bản trong cửa hàng
ID giao dịch trong cửa hàng
ID giao dịch gốc trong cửa hàng
Thời điểm thực hiện giao dịch mua
Môi trường (Sandbox, Production)
Liệu đây có phải là giao dịch hoàn tiền hay không
Liệu đây có phải là giao dịch mua consumable hay không
Example
{
"data": {
"app_id": "14c3d333-2f3a-455a-aa86-ef83dff6913b",
"profile_id": "d8533a10-bcce-4e33-8c9d-88b05ac56559",
"customer_user_id": "77B14FB4-FD2A-4D38-AA3A-4C433F79863C",
"total_revenue_usd": 9.99,
"segment_hash": "fdaeef7f8aaa33c9",
"timestamp": 1733324566777,
"custom_attributes": [
{
"key": "favourite_sport",
"value": "yoga"
}
],
"access_levels": [
{
"access_level_id": "premium",
"store": "app_store",
"store_product_id": "unlimited.9999",
"store_base_plan_id": null,
"store_transaction_id": "2000000335013007",
"store_original_transaction_id": "2000000335013007",
"offer": null,
"starts_at": null,
"purchased_at": "2024-12-24T10:50:23+00:00",
"originally_purchased_at": "2024-12-24T10:50:23+00:00",
"expires_at": null,
"renewal_cancelled_at": "2025-01-05T13:27:47.461425+00:00",
"billing_issue_detected_at": null,
"is_in_grace_period": false,
"cancellation_reason": null
}
],
"subscriptions": [
{
"store": "app_store",
"store_product_id": "unlimited.9999",
"store_base_plan_id": null,
"store_transaction_id": "2000000815013007",
"store_original_transaction_id": "2000000815013007",
"offer": null,
"environment": "Sandbox",
"purchased_at": "2024-12-24T10:50:23+00:00",
"originally_purchased_at": "2024-12-24T10:50:23+00:00",
"expires_at": null,
"renewal_cancelled_at": null,
"billing_issue_detected_at": null,
"is_in_grace_period": false,
"cancellation_reason": null
}
],
"non_subscriptions": [
{
"purchase_id": "7a5f9a7d-e236-33e6-96d8-53a3c59c5562",
"store": "app_store",
"store_product_id": "1year.premium",
"store_base_plan_id": null,
"store_transaction_id": "30002109551456",
"store_original_transaction_id": "30002109551456",
"purchased_at": "2022-10-12T09:42:50+00:00",
"environment": "Production",
"is_refund": false,
"is_consumable": false
}
]
}
}Không được phép truy cập
Schema
Nguồn gốc của lỗi
Mảng các thông báo lỗi
Tên lỗi rút gọn
Mã trạng thái HTTP
Example
{
"errors": [
{
"source": "non_field_errors",
"errors": [
"Authentication credentials were not provided."
]
}
],
"error_code": "not_authenticated",
"status_code": 401
}Không tìm thấy hồ sơ người dùng
Schema
Nguồn gốc của lỗi
Mảng các thông báo lỗi
Tên lỗi rút gọn
Mã trạng thái HTTP
Example
{
"errors": [
{
"source": null,
"errors": [
"Profile not found"
]
}
],
"error_code": "profile_does_not_exist",
"status_code": 404
}Lỗi máy chủ nội bộ