---
title: "Server-side API"
description: "Bắt đầu với server-side API của Adapty để quản lý gói đăng ký."
---

:::tip
Đang dùng AI coding agent? Xem [Kiểm tra và cấp quyền truy cập gói đăng ký từ backend của bạn](server-side-api-with-ai) để có hướng dẫn đầy đủ trên một trang.
:::

Với API, bạn có thể:

1. Kiểm tra trạng thái gói đăng ký của người dùng.
2. Kích hoạt gói đăng ký của người dùng với một mức độ truy cập.
3. Lấy thuộc tính người dùng.
4. Đặt thuộc tính người dùng.
5. Lấy và cập nhật cấu hình paywall.

  <img src="/assets/shared/img/server.webp"
  style={{
    border: '1px solid #727272', /* border width and color */
    width: '700px', /* image width */
    display: 'block', /* for alignment */
    margin: '0 auto' /* center alignment */
  }}
/>

<p> </p>

:::note

Để theo dõi các sự kiện gói đăng ký, hãy dùng tích hợp [Webhook](webhook) trong Adapty hoặc tích hợp trực tiếp với dịch vụ hiện có của bạn.

:::

## Trường hợp 1: Đồng bộ người dùng đăng ký giữa web và mobile \{#case-1-sync-subscribers-between-web-and-mobile\}

Nếu bạn dùng các nhà cung cấp thanh toán web như Stripe, ChargeBee hoặc các dịch vụ khác, bạn có thể dễ dàng đồng bộ người dùng đăng ký. Cách thực hiện:
1. <InlineTooltip tooltip="Gán một ID duy nhất cho mỗi người dùng">[iOS](identifying-users), [Android](android-identifying-users), [React Native](react-native-identifying-users), [Flutter](flutter-identifying-users), và [Unity](unity-identifying-users)</InlineTooltip>.
2. [Kiểm tra trạng thái gói đăng ký của họ](api-adapty/operations/getProfile) bằng API.
3. Nếu người dùng đang dùng gói freemium, hiển thị paywall trên trang web của bạn.
4. Sau khi thanh toán thành công, [cập nhật trạng thái gói đăng ký](api-adapty/operations/setTransaction) trong Adapty qua API.
5. Người dùng đăng ký của bạn sẽ tự động được đồng bộ với ứng dụng mobile.

## Trường hợp 2: Cấp gói đăng ký \{#case-2-grant-a-subscription\}

:::note
Vì lý do bảo mật, bạn không thể cấp gói đăng ký qua SDK.
::: 

Nếu bạn bán hàng qua cửa hàng trực tuyến của mình, Amazon Appstore, Microsoft Store, hoặc bất kỳ nền tảng nào khác ngoài Google Play và App Store, bạn cần đồng bộ các giao dịch đó với Adapty để cung cấp quyền truy cập và theo dõi giao dịch trong analytics.

1. <InlineTooltip tooltip="Gán một ID duy nhất cho mỗi người dùng">[iOS](identifying-users), [Android](android-identifying-users), [React Native](react-native-identifying-users), [Flutter](flutter-identifying-users), và [Unity](unity-identifying-users)</InlineTooltip>.
2. [Thiết lập một cửa hàng tùy chỉnh cho sản phẩm của bạn trong Adapty Dashboard](custom-store).
3. Đồng bộ giao dịch với Adapty bằng yêu cầu API [Set transaction](api-adapty/operations/setTransaction).

## Trường hợp 3: Cấp mức độ truy cập \{#case-3-grant-an-access-level\}

Giả sử bạn đang chạy chương trình khuyến mãi với bản dùng thử miễn phí 7 ngày và muốn trải nghiệm đồng nhất trên tất cả nền tảng. Để đồng bộ điều này với ứng dụng mobile:

1. <InlineTooltip tooltip="Gán một ID duy nhất cho mỗi người dùng">[iOS](identifying-users), [Android](android-identifying-users), [React Native](react-native-identifying-users), [Flutter](flutter-identifying-users), và [Unity](unity-identifying-users)</InlineTooltip>.
2. Dùng API để [cấp quyền truy cập premium](api-adapty/operations/grantAccessLevel) trong 7 ngày.

Sau 7 ngày, người dùng không đăng ký sẽ bị hạ xuống gói miễn phí.

## Trường hợp 4: Đồng bộ thuộc tính và custom attributes của người dùng \{#case-4-sync-users-properties-and-custom-attributes\}

Nếu bạn có custom attributes cho người dùng — chẳng hạn như số từ đã học trong ứng dụng học ngoại ngữ — bạn cũng có thể đồng bộ chúng.

1. <InlineTooltip tooltip="Gán một ID duy nhất cho mỗi người dùng">[iOS](identifying-users), [Android](android-identifying-users), [React Native](react-native-identifying-users), [Flutter](flutter-identifying-users), và [Unity](unity-identifying-users)</InlineTooltip>.
2. [Cập nhật thuộc tính](api-adapty/operations/updateProfile) qua API hoặc SDK.

Các custom attributes này có thể được dùng để tạo phân khúc và chạy A/B test.

## Trường hợp 5: Quản lý cấu hình paywall \{#case-5-manage-paywall-configurations\}

Bạn có thể [cập nhật Remote Config trong paywall](api-adapty/operations/updatePaywall) để điều chỉnh giao diện và hành vi paywall một cách linh hoạt mà không cần triển khai lại ứng dụng.

---

**Tiếp theo:**

- Tiến hành [xác thực cho server-side API](ss-authorization)
- Các yêu cầu:
  - [Lấy hồ sơ người dùng](api-adapty/operations/getProfile)
  - [Tạo hồ sơ người dùng](api-adapty/operations/createProfile)
  - [Cập nhật hồ sơ người dùng](api-adapty/operations/updateProfile)
  - [Xóa hồ sơ người dùng](api-adapty/operations/deleteProfile)
  - [Cấp mức độ truy cập](api-adapty/operations/grantAccessLevel)
  - [Thu hồi mức độ truy cập](api-adapty/operations/revokeAccessLevel)
  - [Đặt giao dịch](api-adapty/operations/setTransaction)
  - [Xác thực giao dịch, cấp mức độ truy cập cho khách hàng và nhập lịch sử giao dịch của họ](api-adapty/operations/validateStripePurchase)
  - [Thêm định danh tích hợp](api-adapty/operations/setIntegrationIdentifiers)
  - [Lấy paywall](api-adapty/operations/getPaywall)
  - [Liệt kê các paywall](api-adapty/operations/listPaywalls)
  - [Cập nhật paywall](api-adapty/operations/updatePaywall)