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
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. Định dạng là Api-Key {YOUR_SECRET_API_KEY}, ví dụ: Api-Key secret_live_....
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
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 (ví dụ: Europe/Berlin). |
Phần thân
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 độ
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
Nếu bạn cần xoay vòng secret API key:
- 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ũ.
- 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: