A resposta curta
O problema terminológico mais difícil em um projeto de Slots API raramente é que ninguém conheça um termo. É que equipes diferentes usam o mesmo termo para objetos diferentes. Por exemplo, “disponível” pode significar listado em um catálogo, conectado em ambiente de homologação, ativado em produção ou verificado para um mercado-alvo. Definições estáveis mantêm perguntas de compras, desenho de interface, evidência de teste e decisões de produção vinculados ao mesmo escopo factual.
Esta página fornece definições concisas que podem ser reutilizadas em todo o site. Para métodos completos de seleção, aceitação, confiabilidade e verificação de mercado, siga os guias temáticos, em vez de tratar o glossário como um tutorial de implementação.
Funções centrais e conceitos de catálogo
| Termo | Definição concisa | O que não estabelece |
|---|---|---|
| Provedor / provedor de jogo | Uma parte que fornece conteúdo de jogo, serviços de jogo ou interfaces relacionadas. | Que a AG detenha direitos de distribuição ou que o conteúdo esteja disponível em um mercado específico. |
| Agregador | Uma camada de integração que normaliza ou coordena o acesso entre uma plataforma e múltiplos provedores. | Que diferenças entre provedores, termos comerciais, certificação ou revisão de mercado desapareçam. |
| Plataforma | Um sistema de negócio que gerencia contas de jogadores, carteiras, operações ou a experiência de front-end. | Que ela seja o provedor, RGS ou operador legalmente responsável em uma jurisdição específica. |
| Operador / entidade operadora | A entidade responsável pelas operações dentro de um escopo de projeto ou mercado especificado; seu significado preciso depende do contrato e da jurisdição. | Que conectar uma API conceda autorização para operar. |
| RGS / Remote Game Server | Um componente de sistema que hospeda ou coordena a operação remota do jogo, o estado e interações de transação relacionadas. | Que seja o agregador ou que sistemas com nomes semelhantes tenham o mesmo escopo de certificação. |
| Catálogo / catálogo de jogos | Uma coleção de registros de jogos com proveniência, identidade, versão, status e informações de revisão. | Que a inclusão no catálogo signifique inventário em tempo real, ativação de produção ou admissão de mercado. |
| ID de registro de catálogo | Um identificador interno que acompanha de forma consistente um registro de catálogo. | Que ele substitua um código de jogo do provedor ou ID de transação. |
| Código de jogo do provedor | O código usado por um provedor ou interface a montante para identificar um jogo de modo único. | Que possa ser inferido de um nome de exibição ou de um slug de página, isto é, o identificador técnico usado na URL. |
| Versão do jogo | Uma versão identificável do software do jogo ou de uma build de conteúdo. | Que ela seja idêntica à versão do modelo matemático. |
| Versão do modelo matemático | A versão do modelo matemático que rege probabilidades, prêmios e características estatísticas teóricas. | Que uma interface inalterada signifique que o modelo não mudou. |
Sessões, rodadas e transações
| Termo | Definição concisa | O que não estabelece |
|---|---|---|
| Lançamento | O processo pelo qual uma plataforma solicita e entra em um jogo especificado usando parâmetros acordados. | Que receber um resultado de lançamento conclua o fluxo do jogo ou a revisão do mercado-alvo. |
| URL de lançamento | Uma URL de entrada do jogo, ou endereço que contém token, gerado para um contexto específico de lançamento. | Que seja um link público permanente ou possa ser divulgado e reutilizado fora do escopo acordado. |
| Sessão de jogo | Um contexto de interação delimitado para um usuário, jogo e ambiente identificados após a entrada no jogo. | Que seja a conta do jogador, sessão de login, carteira ou uma rodada. |
| Rodada | Uma unidade de negócio que agrupa um ou mais eventos de aposta e resultado segundo as regras do jogo. | Que uma rodada sempre corresponda a uma transação. |
| Transação | Um registro de negócio auditável que altera um saldo ou estado de negócio. | Que o sucesso da API signifique que todos os sistemas alcançaram consistência final. |
| Aposta | Um tipo de transação que solicita ou confirma a dedução de uma aposta dentro de uma rodada especificada. | Que a animação no lado do cliente comprove que o débito foi bem-sucedido. |
| Ganho | Um tipo de transação que aumenta um saldo ou cria um valor a pagar a partir de um resultado confirmado. | Qualquer resultado em outra rodada ou retorno de longo prazo de um jogador. |
| Reembolso | Uma devolução baseada em regras de todo ou parte do efeito de uma transação existente. | Que excluir a transação original seja uma implementação aceitável. |
| Rollback / reversão | Uma operação rastreável que compensa um efeito de negócio existente. | Que uma solicitação de reembolso arbitrária possa ser repetida; ela deve referenciar o objeto original e preservar a idempotência. |
| Saldo | O estado monetário usado para uma decisão de negócio de uma conta, moeda e ponto no tempo especificados. | Que uma única leitura comprove que todos os registros assíncronos estão reconciliados. |
| Moeda | A unidade monetária e regras de precisão usadas para exibição, aposta, liquidação ou relatório. | Que o suporte técnico à moeda estabeleça permissão no mercado-alvo. |
Conceitos de carteira e confiabilidade
| Termo | Definição concisa | O que não estabelece |
|---|---|---|
| Carteira única | Um modelo no qual a plataforma gerencia o saldo do jogador e as transações de jogo colaboram com a carteira da plataforma por APIs em tempo real. | Que desapareçam requisitos de timeouts, duplicidades, estados desconhecidos e reconciliação. |
| Carteira de transferência | Um modelo no qual os fundos se movem entre carteiras do lado da plataforma e do lado do jogo e são registrados separadamente. | Que os dois saldos sejam inerentemente consistentes em tempo real. |
| Callback | Uma interação de servidor para servidor na qual uma parte notifica um endereço acordado sobre um evento ou solicita tratamento de negócio. | Ordem de chegada, unicidade ou entrega exatamente uma vez, a menos que o protocolo o determine. |
| Idempotência | A propriedade de que o tratamento repetido da mesma solicitação de negócio não cria um efeito de negócio duplicado. | Apenas devolver a mesma resposta; o sistema deve reconhecer a mesma intenção e preservar o resultado relevante. |
| Chave de idempotência | Uma chave estável usada para identificar a mesma solicitação de negócio. | Que a chave possa ser regenerada a cada retentativa ou reutilizada sem escopo para sempre. |
| Retentativa | Outra tentativa sob condições limitadas, contagem e política de recuo quando a conclusão não foi estabelecida. | Que um timeout equivale a falha; uma retentativa insegura pode criar um efeito duplicado. |
| Estado desconhecido | Um estado no qual o chamador não consegue determinar, a partir da resposta atual, se a ação de negócio foi concluída. | Que o sistema possa lançar imediatamente sucesso ou falha; ele deve consultar, repetir com segurança sob semântica explícita ou reconciliar. |
| ID de correlação | Um identificador de rastreamento que vincula solicitações, callbacks, logs e registros entre sistemas. | Que ele substitua um ID de transação de negócio ou chave de idempotência. |
| Reconciliação | O processo de comparar registros independentes de transação, rodada ou saldo para identificar e resolver divergências. | Idempotência em tempo real, consulta de estado ou controles de exceção. |
| Estado final | Um estado de negócio que o protocolo define como não mais alterado pelo processo normal. | Que uma resposta HTTP de sucesso seja, por si só, o estado final de negócio. |
Ambientes, versões e evidências de mercado
| Termo | Definição concisa | O que não estabelece |
|---|---|---|
| Homologação | Um ambiente e configuração não produtivos usados para integração, verificação e aceitação. | Que uma aprovação em ambiente de homologação signifique que a produção foi implantada ou que o comportamento real de negócio foi verificado. |
| Produção | O ambiente que processa tráfego e dados ativos autorizados. | Que uma URL ou credencial de produção signifique que todo jogo, mercado e versão foi aprovado. |
| Versão da API | Uma versão identificável de contratos de interface, campos e comportamento. | Que a versão do jogo ou do modelo matemático seja a mesma. |
| Versão de integração | Um registro versionado da topologia e configuração selecionadas entre plataforma, agregador, RGS e provedor. | Que evidências antigas continuem a se aplicar depois de mudar um componente crítico. |
| RTP / Return to Player | O retorno médio teórico sobre um grande número de eventos sob regras de jogo definidas e um modelo matemático especificado. | Um resultado para um evento, período curto ou jogador individual. |
| RNG / Gerador de números aleatórios | Um componente ou mecanismo que fornece valores aleatórios para resultados de jogo ou processos aleatórios relacionados. | Que sua implementação, versão ou certificação tenha sido verificada apenas porque RNG é mencionado. |
| Certificação / evidência de conformidade | Evidência de teste ou conformidade produzida por um órgão especificado para um objeto, versão, requisitos e escopo definidos. | Uma licença mundial ou cobertura automática de uma entidade operadora, marca, domínio ou nova versão. |
| Certificação de integração | Evidência de conformidade para uma combinação especificada e escopo de interação que envolve componentes como plataforma, RGS, agregador e provedor. | Toda outra revisão exigida para um jogo individual ou entidade operadora. |
| Órgão de testes | Uma organização que executa testes ou emite relatórios dentro de um escopo de reconhecimento definido. | Que todos os serviços e relatórios do órgão estejam dentro do reconhecimento de um regulador. |
| Padrão | Uma especificação que descreve requisitos técnicos, de teste ou de controle. | Que aplicar um padrão de laboratório como GLI-19 conceda automaticamente admissão jurisdicional. |
| Disponibilidade de mercado | Um status com escopo formado por mercado-alvo, entidade operadora, jogo e versão, certificação, moeda, idioma, direitos e uma decisão de projeto. | Uma conclusão que a inclusão no catálogo, idioma, moeda ou conectividade de API possa estabelecer isoladamente. |
| Suporte de idioma | Uma capacidade de idioma verificada para um escopo definido de interface, regras, ajuda ou comunicação. | Tradução completa, certificação válida ou disponibilidade no mercado. |
Nota de escopo não verificado para
RTP 0–1000Este intervalo numérico não é a definição de RTP do glossário. Ele ainda requer definições de sua unidade e significado, versão do modelo matemático, permissões de acesso, material de testes e certificação, mercado-alvo e apresentação. Não deve ser interpretado como uma alegação verificada de desempenho, retorno ou conformidade de mercado.
Ambiguidades comuns a eliminar
| Declaração ambígua | Fatos que devem ser separados |
|---|---|
| “Está no catálogo, então está disponível.” | Catalogado, verificado em ambiente de homologação, ativado em produção, comercialmente disponível e verificado para o mercado-alvo |
| “A solicitação expirou, então falhou.” | Resultado de transporte desconhecido, estado de negócio desconhecido, falha confirmada, retentativa segura e requisito de reconciliação |
| “Uma rodada equivale a uma transação.” | Uma rodada é uma unidade de negócio do jogo; aposta, ganho, reembolso e rollback podem ser transações separadas |
| “BRL e português são suportados, então o Brasil está pronto.” | Moeda, idioma, versão do jogo, topologia de integração, certificação, entidade operadora, marca ou domínio e regras de mercado |
| “Há certificação, então funciona no mundo inteiro.” | Reconhecimento do órgão de testes, padrão, objeto testado, versão, jurisdição, validade e condições do projeto |
O que pode ser avaliado atualmente neste site
- A referência pública da API usa conceitos que incluem catálogo, lançamento, carteira única, carteira de transferência, registros e processo de integração.
- Guias de confiabilidade explicam por que solicitações duplicadas, timeouts, falhas de callback, estados desconhecidos e reconciliação pertencem a um único projeto.
- Este glossário cria definições concisas para uso em todo o site sem acrescentar endpoints, métodos de assinatura, credenciais ou fatos de protocolo de produção.
- O catálogo mostra 11 provedores e 1.194 nomes de jogos. É um retrato no nível de nomes — não uma conclusão sobre fornecimento em tempo real, ativação de produção, direitos de conteúdo, versões, certificação ou disponibilidade no mercado-alvo.
Limites a considerar
- Não se promete campo de API específico, protocolo de produção, implementação de carteira, nível de desempenho, SLA ou data de lançamento.
- Não se promete que jogo, provedor, certificado, idioma ou moeda específico esteja atualmente disponível em um mercado-alvo.
- Estas definições gerais não substituem contrato, especificação de interface, regra regulatória ou aprovação de projeto.
- A expressão comercial
RTP 0–1000é mantida como termo com escopo, mas não representa uma definição numérica verificada, capacidade universal, resultado para jogador ou fato de admissão de mercado.
FAQ
Um provedor e um agregador são o mesmo tipo de empresa?
Eles são funções diferentes. Um provedor fornece principalmente conteúdo ou serviços de jogo; um agregador coordena o acesso entre múltiplos provedores e uma plataforma. Uma empresa pode desempenhar várias funções, mas os registros do projeto ainda devem separar suas responsabilidades reais.
Callback, transação e rodada devem usar o mesmo ID?
Normalmente, eles não devem ser reduzidos a um único identificador. Um callback é um mecanismo de interação, uma transação é uma mudança de estado de negócio e uma rodada é uma unidade de negócio do jogo. Cada um precisa de identidade estável, e IDs de correlação os conectam sob o contrato de interface.
RTP significa que um jogador recebe essa porcentagem todas as vezes?
Não. RTP é uma medida estatística teórica de longo prazo sob regras especificadas e um modelo matemático. Ele não garante o resultado de um evento ou de curto prazo. Qualquer valor numérico também precisa de versão de jogo e modelo matemático, evidência de teste e escopo de apresentação.
Leituras relacionadas e próximos passos
Os sete primeiros guias abrangem as questões completas por trás destas definições:
- O que é uma Slots API com múltiplos provedores? — os objetos e limites conectados pela agregação.
- API de agregador vs. integração direta com provedores — as compensações entre rotas de integração.
- Como avaliar um provedor de Slots API — evidências de compras e perguntas de diligência prévia.
- Da homologação à produção — evidências para uma decisão de produção.
- Idempotência, retentativas e reconciliação — tratamento de falhas, duplicidades e estados desconhecidos.
- Governança de dados do catálogo de jogos — campos, estados do ciclo de vida, versões e responsabilidade.
- Matriz de mercado, jogo, versão e certificação — verificação de mercado-alvo por objeto e escopo.
Páginas principais: referência pública da API, catálogo de jogos e processo de integração.
Ao usar a seção “Fale conosco”, descreva com estes termos o mercado-alvo, o escopo de catálogo, o modelo de carteira, o ambiente e as versões. A AG poderá então confirmar a terminologia e o escopo de evidência antes de uma conversa sobre o projeto. Isto não é um compromisso de fornecimento, certificação ou produção.
Fontes e escopo
- Página inicial da AG Game
- Documentação pública da API
- Catálogo de jogos e escopo da contagem
- UK Gambling Commission RTS 3: regras, descrições de jogos e probabilidade de ganhar
- SPA do Ministério da Fazenda do Brasil: FAQ técnico
- Gaming Laboratories International: padrões
Fontes regulatórias e de padrões são usadas para explicar a terminologia. Elas não comprovam que um projeto tenha atendido aos requisitos referenciados. Para um projeto específico, confirme que cada definição corresponde à interface atual, contrato e regras do mercado-alvo.
Precisa transformar estas orientações em um plano de projeto?
Este artigo apoia a avaliação do projeto e não substitui a validação técnica, contratual, de certificação ou da legislação local.
