🔍 Visão Geral
A API PREMIUM é um sistema de integração de jogos que permite:
- Lançamento de jogos para usuários
- Gerenciamento de saldo de usuários
- Processamento de transações de jogos em tempo real
- Sistema de callback para atualização automática de saldos
- Suporte ao provedor PGSOFT
📝 Nota: A API suporta jogos PGSOFT e inclui sistema de verificação de IP para segurança.
🔐 Autenticação
A API PREMIUM utiliza as seguintes credenciais para autenticação:
{
"agentToken": "seu_agent_token",
"secretKey": "sua_secret_key",
"agent_code": "seu_agent_code"
}
Essas credenciais devem ser configuradas no painel administrativo e são utilizadas em todas as requisições.
🌐 Endpoints
1. Lançamento de Jogo
POST
https://apinovapg.shop/api/v1/game_launch
Parâmetros de Requisição:
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| agentToken | string | Sim | Token de autenticação do agente |
| secretKey | string | Sim | Chave secreta para autenticação |
| user_code | integer | Sim | ID único do usuário |
| provider_code | string | Sim | Código do provedor (ex: "PGSOFT") |
| game_code | string | Sim | Código do jogo a ser lançado |
| user_balance | float | Sim | Saldo atual do usuário |
| game_type | string | Não | Tipo do jogo (opcional) |
Exemplo de Requisição:
{
"agentToken": "ae76d5f8-e6ca-4d46-a309-6900e29b8b60",
"secretKey": "ae76d5f8-e6ca-4d46-a309-6900e29b8b60",
"user_code": 822,
"provider_code": "PGSOFT",
"game_code": "fortune-tiger",
"user_balance": 865.60,
"game_type": "slot"
}
Resposta de Sucesso:
{
"status": 1,
"msg": "SUCCESS",
"launch_url": "https://apinovapg.shop/67/index.html?operator_token=Zm9saWFiZXQ=&btt=1&t=74f7ada5-aa6c-44f1-9b2d-0384c84f3b32&or=apinovapg.shop&api=apinovapg.shop",
"user_code": "822",
"user_balance": 865.6,
"user_created": false,
"currency": "BRL"
}
Resposta de Erro:
{
"status": "error",
"message": "Voce precisa passar o user_code."
}
2. Consulta de Agente
POST
https://apinovapg.shop/api/v1/getagent
Parâmetros de Requisição:
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| agentToken | string | Sim | Token de autenticação do agente |
| secretKey | string | Sim | Chave secreta para autenticação |
Exemplo de Requisição:
{
"agentToken": "ae76d5f8-e6ca-4d46-a309-6900e29b8b60",
"secretKey": "ae76d5f8-e6ca-4d46-a309-6900e29b8b60"
}
Resposta de Sucesso:
{
"id": 1,
"agentcode": "AGENT001",
"callbackurl": "https://seudominio.com.br/callback/",
"probganho": "0.95",
"probbonus": "0.10",
"probganhortp": "0.96",
"probganhoinfluencer": "0.98",
"probbonusinfluencer": "0.15",
"probganhoaposta": "0.97",
"probganhosaldo": "0.99"
}
🔄 Sistema de Callback
O sistema utiliza callbacks automáticos para processar as transações dos jogos. O callback é enviado para a URL configurada no agente.
URL do Callback
https://apinovapg.shop/callback/gold_api/game_callback
Estrutura do Callback:
Dados Enviados no Callback
POST
https://apinovapg.shop/callback/gold_api/game_callback
Estrutura dos Dados:
{
"agent_code": "AGENT001",
"agent_secret": "ae76d5f8-e6ca-4d46-a309-6900e29b8b60",
"user_code": "822",
"user_balance": 865.60,
"user_total_credit": 150.00,
"user_total_debit": 100.00,
"game_type": "slot",
"slot": {
"provider_code": "PGSOFT",
"game_code": "fortune-tiger",
"round_id": "123456789",
"type": "BASE",
"bet": 10.00,
"win": 15.50,
"txn_id": "TXN123456789",
"txn_type": "debit_credit",
"is_buy": false,
"is_call": false,
"user_before_balance": 850.00,
"user_after_balance": 865.60,
"agent_before_balance": 100,
"agent_after_balance": 100,
"created_at": "2024-01-15T10:30:00Z"
}
}
Resposta Esperada:
{
"status": 1,
"user_balance": 865.60
}
📝 Nota: O callback é enviado automaticamente após cada transação de jogo. Certifique-se de que sua URL de callback esteja configurada corretamente no painel do agente.
💡 Exemplos de Uso
Exemplo 1: Lançar um Jogo PGSOFT
// Requisição para lançar jogo
POST https://apinovapg.shop/api/v1/game_launch
Content-Type: application/json
{
"agentToken": "seu_token_aqui",
"secretKey": "sua_chave_aqui",
"user_code": 123,
"provider_code": "PGSOFT",
"game_code": "fortune-tiger",
"user_balance": 100.00,
"game_type": "slot"
}
// Resposta
{
"status": 1,
"msg": "SUCCESS",
"launch_url": "https://apinovapg.shop/67/index.html?operator_token=...",
"user_code": "123",
"user_balance": 100.0,
"user_created": false,
"currency": "BRL"
}
Exemplo 2: Consultar Dados do Agente
// Consulta de dados do agente
POST https://apinovapg.shop/api/v1/getagent
Content-Type: application/json
{
"agentToken": "seu_token_aqui",
"secretKey": "sua_chave_aqui"
}
// Resposta
{
"id": 1,
"agentcode": "AGENT001",
"callbackurl": "https://seudominio.com.br/callback/",
"probganho": "0.95",
"probbonus": "0.10"
}
❌ Códigos de Erro
| Status | Mensagem | Descrição |
|---|---|---|
| error | Voce precisa passar o user_code. | Parâmetro user_code é obrigatório |
| error | User Balance deve ser um numero. | Parâmetro user_balance deve ser numérico |
| error | Agent Token não cadastrado. | agentToken inválido ou não encontrado |
| error | Secret Key não cadastrado. | secretKey inválido ou não encontrado |
| 500 | InternalError | Erro interno do servidor (código: G1008) |
⚠️ Importante: Todos os erros retornam status HTTP 200 com o campo "status" indicando o tipo de erro. Verifique sempre o campo "message" para detalhes específicos.
📞 Suporte
Para dúvidas ou suporte técnico, entre em contato com nossa equipe de desenvolvimento.
✅ Status: API PREMIUM ativa e funcionando com suporte ao provedor PGSOFT.
🔧 Provedor Suportado:
- PGSOFT: Jogos próprios hospedados localmente