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:

HeaderMô 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:

  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: