ÿÿ Xác thá»±c và định dạng yêu cầu API phía máy chủ
English 中文TürkçeРуÑÑкийEspañol日本語Tiếng Việt

Xác thực và định dạng yêu cầu API phía máy chủ

Xác thực

Các yêu cầu API phải được xác thá»±c bằng secret key hoặc public API key của bạn thông qua header Authorization. Bạn có thể tìm thấy chúng trong App Settings. Äịnh dạng giá trị là Api-Key {your-secret-api-key}, ví dụ: Api-Key secret_live_....

API key là theo 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 máy chủ yêu cầu các header cụ thể và phần thân JSON. Sử dụng thông tin bên dưới để cấu trúc yêu cầu của bạn.

HeaderMô tả
adapty-profile-id

ID hồ sÆ¡ ngÆ°á»i dùng Adapty của ngÆ°á»i dùng. Hiển thị trong trÆ°á»ng Adapty ID trên trang Adapty Dashboard -> Profiles -> trang hồ sÆ¡ cụ thể.

Có thể dùng thay thế cho adapty-customer-user-id, dùng má»™t trong hai Ä‘á»u được.

adapty-customer-user-id

ID ngÆ°á»i dùng trong hệ thống của bạn. Hiển thị trong trÆ°á»ng Customer user ID trên trang Adapty Dashboard -> Profiles -> trang hồ sÆ¡ cụ thể.

Có thể dùng thay thế cho adapty-profile-id, dùng má»™t trong hai Ä‘á»u được.

âš ï¸ Chỉ hoạt Ä‘á»™ng nếu bạn xác định ngÆ°á»i dùng trong ứng dụng trong mã ứng dụng bằng Adapty SDK.

adapty-platform(tùy chá»n) Chỉ định ná»n tảng của thiết bị mà ứng dụng được cài đặt. Chúng tôi khuyến nghị đặt tham số này trong các yêu cầu Create profile và Update profile khi chỉnh sá»­a đối tượng Installation Meta, vì nó phụ thuá»™c vào thiết bị ngÆ°á»i dùng Ä‘ang dùng và má»™t ngÆ°á»i dùng có thể có nhiá»u thiết bị. Các giá trị có thể có: iOS, macOS, iPadOS, visionOS, Android, hoặc web.
Content-TypeÄặt thành application/json để API xá»­ lý yêu cầu.

Body

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

Giới hạn tốc độ

Äể tránh bị throttle, hãy đảm bảo số lượng yêu cầu (má»—i ứng dụng) không vượt quá 40.000 yêu cầu má»—i phút.

Nếu vượt quá giá»›i hạn này, hệ thống có thể bị chậm hoặc tạm thá»i chặn các yêu cầu tiếp theo nhằm duy trì hiệu suất tối Æ°u cho tất cả ngÆ°á»i dùng.

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:

ÿÿÿÿ