API para desenvolvedores NowG
A API NowG permite transmitir o comportamento do jogador para a plataforma e receber resultados do modelo — pontuações de coorte, alertas de tilt e sinais de qualidade para afiliados — de volta como webhooks. É uma API JSON/HTTPS; cada solicitação é limitada a um único locatário por seu token de portador. URL base: https://api.nowg.net/v1.
Autenticação
Todas as solicitações usam um token de portador com escopo para um único locatário. Gere e rotacione chaves no painel de controle em Configurações → APIEnvie-o para o Authorization cabeçalho: Authorization: Bearer $KEYAs chaves têm escopo de ambiente (teste/produção) e nunca expiram até serem rotacionadas.
Limites de taxa
A ingestão é limitada pela taxa de 500 solicitações por segundo por locatário, com possibilidade de expansão até 1,000. Lotes contam como uma única solicitação. Quando a taxa de transferência for limitada, você receberá 429 com uma Retry-After cabeçalho — recue e tente novamente; a ingestão é idempotente, portanto, as repetições são seguras.
Eventos de jogadores
Transmita eventos comportamentais em tempo real para que os modelos possam avaliar o apetite por volatilidade, o risco de inclinação e a qualidade da coorte. Os eventos são desduplicados por event_id.
Importação em lote
Preencha o histórico enviando um array de até Eventos 1,000 para /v1/players/events/batchA resposta retorna por item. accepted e deduped contagens. A ordem não importa — os eventos são registrados com carimbo de data/hora por ts, não a chegada.
Deduplicação
Cada evento carrega um event_id Você controla. O NowG armazena isso por 30 dias; uma repetição dentro desse período é ignorada silenciosamente (contada como dedupedIsso torna as novas tentativas, as filas de "pelo menos uma vez" e as repetições completamente seguras.
Webhook: pontuações da coorte
Quando o modelo de reavaliação de um jogador for concluído, o NowG POSTA um cohort.scored evento para o seu URL de webhook com pontuações de volatilidade, risco de inclinação e qualidade do afiliado (0–1). Registre o URL em Configurações → Webhooks.
Webhook: alertas de inclinação
A tilt.alert O evento é acionado quando um jogador ultrapassa o limite de tilt configurado, executando a intervenção recomendada (tempo de espera, aviso de limite, sem bônus). Todos os alertas são registrados para auditoria no Compliance Guardian.
Webhook: configuração de postback
Para enviar sinais de qualidade de afiliado de volta ao seu rastreador, adicione o URL de postback em Configurações → Integrações com o {click_id} e {quality_score} macros. O NowG aciona essa comunicação servidor a servidor sempre que a pontuação de uma coorte muda significativamente.