---
title: Xác thực và định dạng yêu cầu cho API Xuất dữ liệu phân tích
---

## Xác thực \{#authorization\}

Bạn cần xác thực các yêu cầu API bằng secret API key của mình thông qua header Authorization. Bạn có thể tìm thấy nó trong [App Settings](https://app.adapty.io/settings/general). Định dạng là `Api-Key {YOUR_SECRET_API_KEY}`, ví dụ: `Api-Key secret_live_...`.

:::important
API key gắn với từng ứng dụng. Nếu bạn có nhiều ứng dụng, hãy đảm bảo sử dụng các key khác nhau cho mỗi ứng dụng.
:::

## Định dạng yêu cầu \{#request-format\}

**Headers**

Các yêu cầu API phía server yêu cầu headers cụ thể và phần thân JSON. Sử dụng thông tin dưới đây để cấu trúc yêu cầu của bạn:

| Header       | Mô tả                                                        |
| ------------ | ------------------------------------------------------------ |
| Content-Type | (Bắt buộc) Đặt thành `application/json` để API xử lý yêu cầu. |
| Adapty-Tz    | (Tùy chọn) Đặt múi giờ để xác định cách dữ liệu được nhóm và hiển thị. Sử dụng [định dạng IANA Time Zone Database](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) (ví dụ: `Europe/Berlin`). |

## Phần thân \{#body\}

API yêu cầu phần thân định dạng JSON với dữ liệu cần thiết cho yêu cầu.

## Giới hạn tốc độ \{#rate-limits\}

Tối đa 2 yêu cầu mỗi giây cho mỗi API key. Vượt quá giới hạn này sẽ trả về lỗi `429 Too Many Requests`.

## Xoay vòng API key \{#rotate-api-keys\}

Nếu bạn cần xoay vòng secret API key:

1. Trong **Settings → General**, nhấp vào **Generate new key**, sau đó nhấp vào biểu tượng thùng rác bên cạnh key cũ.
2. Cập nhật key đang dùng trong ứng dụng của bạn.

---

**Tiếp theo: Các yêu cầu:**

- [Truy xuất dữ liệu phân tích](api-export-analytics/operations/retrieveAnalyticsData)
- [Truy xuất dữ liệu cohort](api-export-analytics/operations/retrieveCohortData)
- [Truy xuất dữ liệu chuyển đổi](api-export-analytics/operations/retrieveConversionData)
- [Truy xuất dữ liệu phễu](api-export-analytics/operations/retrieveFunnelData)
- [Truy xuất dữ liệu Lifetime Value (LTV)](api-export-analytics/operations/retrieveLTVData)
- [Truy xuất dữ liệu giữ chân người dùng](api-export-analytics/operations/retrieveRetentionData)