# Adapty Mail API

Version: `1.0.0`

> Adapty Mail API cho phép bạn gửi hồ sơ người dùng và các sự kiện giao dịch đến Adapty Mail trực tiếp
> từ máy chủ của bạn, mà không cần định tuyến dữ liệu qua SDK.
>
> Sử dụng để:
>
> Thêm người đăng ký khi bạn chưa có cơ sở dữ liệu trong Adapty Mail.
> Tái sử dụng cơ sở người đăng ký từ các ứng dụng khác của bạn.
> Cung cấp dữ liệu cho Adapty Mail theo hướng server-to-server, với backend của bạn là nguồn dữ liệu chính.
>
> Một hồ sơ người dùng có email là đủ cho flow **never purchased**. Mọi flow khác
> (renewal cancelled, billing issue, expired, refunded) đều được điều khiển bởi lịch sử mua hàng, vì vậy những
> hồ sơ đó cũng cần có sự kiện giao dịch để được đặt vào đúng flow.
>
> Để xem hướng dẫn từng bước, hãy xem [Gửi email và giao dịch qua Adapty Mail API](/docs/mail-send-data-via-api).

## Servers

- `https://api-mail.adapty.io` — Máy chủ production

## Authentication

### apikeyAuth

type: `apiKey` · in: `header` · header: `Authorization`

Xác thực mọi yêu cầu bằng secret API key của Adapty Mail, được gửi dưới dạng header **Authorization**
với giá trị `Bearer {your_secret_api_key}`, ví dụ: `Bearer secret_live_...`.

Tìm key này trong Adapty Mail tại **Settings**. Key này dành riêng cho từng dự án — nó xác định
dự án mà dữ liệu thuộc về, vì vậy các endpoint hồ sơ và giao dịch không cần nhận project ID.

## Operations

- **POST** `/api/v1/profile/save/` — [Lưu hồ sơ người dùng](https://adapty.io/docs/vi/api-mail/operations/saveProfile.md)
- **POST** `/api/v1/profile/transaction-event/save/` — [Lưu sự kiện giao dịch](https://adapty.io/docs/vi/api-mail/operations/saveTransactionEvent.md)