API dành cho nhà phát triển NowG

API của NowG cho phép bạn truyền tải hành vi người chơi vào nền tảng và nhận lại các kết quả đầu ra từ mô hình — điểm số nhóm, cảnh báo về sự mất cân bằng và tín hiệu chất lượng đối tác liên kết — dưới dạng webhook. Đây là API JSON/HTTPS; mỗi yêu cầu được giới hạn trong một tenant duy nhất thông qua mã thông báo bearer của nó. URL cơ sở: https://api.nowg.net/v1.

Xác thực

Tất cả các yêu cầu đều sử dụng mã thông báo bearer có phạm vi giới hạn cho một người dùng duy nhất. Tạo và xoay vòng khóa từ bảng điều khiển bên dưới. Cài đặt → APIHãy gửi nó theo Authorization tiêu đề: Authorization: Bearer $KEYCác khóa này chỉ có hiệu lực trong phạm vi môi trường (thử nghiệm/thực tế) và sẽ không bao giờ hết hạn cho đến khi được xoay vòng.

Giới hạn tỷ lệ

Quá trình hấp thụ bị giới hạn về tốc độ. 500 yêu cầu/giây Mỗi người dùng có thể giới hạn tối đa 1,000 yêu cầu. Mỗi lô được tính là một yêu cầu. Khi bị giới hạn tốc độ, bạn sẽ nhận được thông báo. 429 với một Retry-After tiêu đề — lùi lại và thử lại; quá trình nhập liệu là bất biến, vì vậy việc phát lại là an toàn.

Sự kiện người chơi

Truyền phát các sự kiện hành vi theo thời gian thực để các mô hình có thể đánh giá mức độ chấp nhận biến động, rủi ro nghiêng lệch và chất lượng nhóm. Các sự kiện trùng lặp được loại bỏ bằng cách... event_id.

nhập hàng loạt

Điền lại lịch sử bằng cách gửi một mảng lên đến... Sự kiện 1,000 đến /v1/players/events/batchPhản hồi trả về dữ liệu cho từng mục. accepted và deduped số lượng. Thứ tự không quan trọng — các sự kiện được đánh dấu thời gian bởi tsKhông phải là đến nơi.

Sự trùng lặp

Mỗi sự kiện đều mang một ý nghĩa nào đó. event_id Bạn kiểm soát. NowG lưu trữ nó trong 30 ngày; sự lặp lại trong khoảng thời gian đó sẽ bị bỏ qua một cách âm thầm (được tính trong vòng 30 ngày). dedupedĐiều này giúp cho việc thử lại, xếp hàng chờ ít nhất một lần và phát lại hoàn toàn an toàn.

Webhook: điểm số nhóm

Khi mô hình chấm điểm lại cho người chơi hoàn tất, NowG sẽ ĐĂNG một thông báo. cohort.scored Thêm sự kiện vào URL webhook của bạn với điểm số về độ biến động, rủi ro mất cân bằng và chất lượng liên kết (0–1). Đăng ký URL dưới Cài đặt → Webhooks.

Webhook: cảnh báo độ nghiêng

A tilt.alert Sự kiện được kích hoạt khi người chơi vượt qua ngưỡng mất bình tĩnh đã được thiết lập, kèm theo biện pháp can thiệp được đề xuất (thời gian chờ, nhắc nhở giới hạn, không có phần thưởng). Mọi cảnh báo đều được ghi lại để kiểm toán theo hệ thống Compliance Guardian.

Webhook: thiết lập postback

Để gửi tín hiệu chất lượng liên kết trở lại trình theo dõi của bạn, hãy thêm URL postback của nó vào bên dưới. Cài đặt → Tích hợp với {click_id} và {quality_score} Macro. NowG kích hoạt nó từ máy chủ này sang máy chủ khác bất cứ khi nào điểm số của một nhóm thay đổi đáng kể.