/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 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 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 hồ sơ ẩn danh. Cần cung cấp adapty-customer-user-id hoặc adapty-profile-id.
Responses
Hồ sơ người dùng được truy xuất 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 người dùng của bạn trong hệ thống của bạn
Giá trị float biểu thị tổng doanh thu tính bằng USD kiếm đượ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, cần để giải quyết điều kiện tranh chấp
Tối đa 30 thuộc tính tùy chỉnh được phép đặt cho hồ sơ người dùng
Khóa phải là chuỗi không quá 30 ký tự. Chỉ cho phép 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 quá 50 ký tự. Chỉ cho phép chuỗi và số thực 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
Đị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
Thông tin ưu đãi, nếu có áp dụng ưu đãi hoặc ưu đãi giới thiệu
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 vấn đề thanh toán
Liệu 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
Thông tin ưu đãi, nếu có áp dụng ưu đãi hoặc ưu đãi giới thiệu
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 gia hạn bị hủy
Thời điểm phát hiện vấn đề thanh toán
Liệu 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 không phải gói đăng ký. Mảng rỗng nếu khách hàng không có giao dịch mua nào
Định danh giao dịch mua 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à 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
Schema
Nguồn gốc lỗi
Mảng 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 lỗi
Mảng 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ộ