API para desarrolladores de NowG
La API de NowG permite transmitir el comportamiento del jugador a la plataforma y recibir resultados del modelo (puntuaciones de cohortes, alertas de inclinación y señales de calidad de afiliados) como webhooks. Es una API JSON/HTTPS; cada solicitud está limitada a un único inquilino mediante su token de portador. URL base: https://api.nowg.net/v1.
Autenticación
Todas las solicitudes utilizan un token de portador con alcance para un solo inquilino. Genere y rote las claves desde el panel de control en Configuración → API. Envíalo en el Authorization encabezamiento: Authorization: Bearer $KEYLas claves tienen un alcance de entorno (prueba/producción) y nunca caducan hasta que se rotan.
Límites de tasa
La ingestión está limitada por la velocidad 500 solicitudes por segundo por inquilino, ampliable hasta 1,000. Los lotes cuentan como una solicitud. Cuando se limita la velocidad, recibe 429 con Retry-After encabezado: retroceda y vuelva a intentarlo; la ingesta es idempotente, por lo que las repeticiones son seguras.
Eventos de jugadores
Transmita eventos de comportamiento en tiempo real para que los modelos puedan calificar el apetito de volatilidad, el riesgo de inclinación y la calidad de la cohorte. Los eventos se deduplican mediante event_id.
Importación por lotes
Rellenar el historial mediante POSTing de una matriz de hasta Eventos 1,000 a /v1/players/events/batchLa respuesta devuelve por artículo. accepted y deduped recuentos. El orden no importa: los eventos se marcan con la hora por ts, no llegada.
Deduplicación
Cada evento conlleva una event_id usted controla. NowG lo almacena durante 30 días; una repetición dentro de ese período se ignora silenciosamente (se cuenta en dedupedEsto hace que los reintentos, las colas de "al menos una vez" y las repeticiones sean completamente seguros.
Webhook: puntuaciones de cohorte
Cuando el modelo que vuelve a puntuar a un jugador se completa, NowG POSTiza un cohort.scored Evento a su URL de webhook con puntuaciones de volatilidad, riesgo de inclinación y calidad de afiliado (0–1). Registre la URL en Configuración → Webhooks.
Webhook: alertas de inclinación
A tilt.alert El evento se activa cuando un jugador supera el umbral de frustración configurado, aplicando la intervención recomendada (tiempo de espera, aviso de límite, sin bonificación). Cada alerta se registra para su auditoría en Compliance Guardian.
Configuración de Webhook: postback
Para enviar señales de calidad de afiliados a su rastreador, agregue su URL de postback en Configuración → Integraciones con el {click_id} y {quality_score} macros. NowG lo ejecuta de servidor a servidor cada vez que la puntuación de una cohorte cambia sustancialmente.