GUCCIFER API · v4.2

Documentação da API de Salas

Sistema completo de criação e gerenciamento de salas. Use Keys Mãe para gerar Keys de Sala ilimitadas ou Seriais com saldo específico.

Base URL
https://guccifersalas.online
Formato
JSON
Métodos
GET / POST

Introdução

A GUCCIFER API permite criar e gerenciar salas de forma automatizada. O sistema utiliza dois tipos principais de autenticação:

  • GUCCIFER-INFINITY-XXXXXXXX — Key Mãe (ilimitada, para revendedores)
  • GUCCIFER-QTD-XXXXXXXX — Key de Sala (com saldo limitado)

Autenticação

Todas as rotas que criam salas exigem uma Key Mãe ou Key de Sala válida no parâmetro oauth_key.

Importante: Keys normais não funcionam para criar salas. Somente Key Mãe ou Key de Sala são aceitas.

Key Mãe (Infinity)

A Key Mãe é ilimitada e permite criar Keys de Sala e Seriais. Formato: GUCCIFER-INFINITY-XXXXXXXX.

GET/infokey?key=SUA_KEY_MAE
request
GET https://guccifersalas.online/infokey?key=GUCCIFER-INFINITY-ABC12345
response
{
  "success": true,
  "tipo": "key_mae",
  "keymae": "GUCCIFER-INFINITY-ABC12345",
  "nome": "Nome do Revendedor",
  "idtelegram": null,
  "ativa": true,
  "saldo": "ilimitado",
  "total_keys_geradas": 518,
  "total_salas_geradas": 140085,
  "criada_em": "2026-07-02 20:10:36",
  "ultimo_uso": "2026-07-07 21:44:15"
}
Atenção: Use o parâmetro key (não oauth_key) para consultar informações de uma key.

Keys de Sala

Keys com saldo limitado para criar salas. Formato: GUCCIFER-QTD-XXXXXXXX (ex: GUCCIFER-100-ABC123).

Criar Key de Sala (requer Key Mãe)

GET/criarkeysala?keymae=KEY_MAE&quantidadekey=1&quantidadesala=100
ParâmetroTipoDescrição
keymaestring obrigatórioSua Key Mãe (GUCCIFER-INFINITY-...)
quantidadekeyint obrigatórioQuantidade de keys a criar
quantidadesalaint obrigatórioSaldo de salas por key (1-10000)
request
GET https://guccifersalas.online/criarkeysala?keymae=GUCCIFER-INFINITY-ABC123&quantidadekey=1&quantidadesala=100
response
{
  "success": true,
  "msg": "Keys de sala geradas com sucesso.",
  "keymae": "GUCCIFER-INFINITY-ABC123",
  "quantidade_keys_gerada": 1,
  "quantidade_sala_por_key": 100,
  "total_salas_geradas": 100,
  "keys": [
    "GUCCIFER-100-XY7Z9A2B"
  ]
}

Consultar Saldo da Key

GET/infokey?key=SUA_KEY
ParâmetroTipoDescrição
keystring obrigatórioKey Mãe ou Key de Sala para consultar
request
GET https://guccifersalas.online/infokey?key=GUCCIFER-100-XY7Z9A2B
response
{
  "success": true,
  "tipo": "key_sala",
  "keysala": "GUCCIFER-100-XY7Z9A2B",
  "quantidade_inicial": 100,
  "saldo": 87,
  "usado": 13,
  "status": "ativa",
  "gerada_em": "2026-07-07 18:57:38",
  "ultimo_uso": "2026-07-07 21:30:00"
}
Dica: Use este endpoint para verificar o saldo restante. Funciona com Key Mãe e Key de Sala.

Deletar Key de Sala (requer Key Mãe)

GET/deletarkeysala?keymae=KEY_MAE&keysala=KEY_SALA
ParâmetroTipoDescrição
keymaestring obrigatórioSua Key Mãe (só pode deletar keys criadas por ela)
keysalastring obrigatórioKey de Sala a ser deletada
response
{
  "success": true,
  "msg": "Key de Sala bloqueada/deletada com sucesso",
  "keysala": "GUCCIFER-100-XY7Z9A2B",
  "keymae": "GUCCIFER-INFINITY-ABC123"
}
Atenção: Só a Key Mãe que criou a Key de Sala pode deletá-la.

Seriais

Códigos únicos para resgate. Formato: GUCCIFER-QTD-XXXXXXXX.

Criar Seriais (requer Key Mãe)

GET/criarseriais?keymae=KEY_MAE&quantidade=10&saldo=5
ParâmetroTipoDescrição
keymaestring obrigatórioSua Key Mãe
quantidadeint obrigatórioQuantidade de seriais (1-100)
saldoint obrigatórioSaldo de cada serial
response
{
  "success": true,
  "msg": "1 seriais criados com sucesso",
  "keymae": "GUCCIFER-INFINITY-ABC123",
  "quantidade": 1,
  "valor_cada": 5,
  "total_valor": 5,
  "seriais": [
    "GUCCIFER-5-ED6BE6MR"
  ]
}

Resgatar Serial

GET/resgatar?seriais=CODIGO&keysala=KEY_SALA
ParâmetroTipoDescrição
seriaisstring obrigatórioCódigo(s) do serial (separados por vírgula)
keysalastring obrigatórioKey de Sala para receber o saldo
response
{
  "success": true,
  "keysala": "GUCCIFER-100-XY7Z9A2B",
  "saldo_anterior": 100,
  "saldo_adicionado": 5,
  "novo_saldo": 105,
  "codigos_resgatados": ["GUCCIFER-5-ABC123"],
  "codigos_nao_resgatados": []
}
Dica: Resgate múltiplos seriais separando por vírgula: seriais=CODE1,CODE2,CODE3

Criar Sala

Cria uma nova sala com configurações específicas. Requer Key Mãe ou Key de Sala.

Rate Limit: Keys de Sala têm limite de 2 segundos entre criações. Keys Mãe não têm rate limit.
GET/api/v1/create:room?oauth_key=KEY&modo=1&senha=00
ParâmetroTipoDescrição
oauth_keystring obrigatórioKey Mãe ou Key de Sala
modoint obrigatórioModo da sala (1-6)
senhastring opcionalSenha da sala
auto_start_minint opcionalMinutos para iniciar automaticamente (padrão: 5, use 0 para manual)
1
Sem Carregamento
2
Gel Infinito
3
Full Capa
4
Com Carregamento
5
Full UMP XM8 + Gel Normal
6
Full UMP XM8 + Gel Infinito
request
GET https://guccifersalas.online/api/v1/create:room?oauth_key=GUCCIFER-50-XY7Z9A2B&modo=3&senha=00
response
{
  "status": "SALA_CRIADA",
  "msg": "sala criada com sucesso",
  "sshash": "56862b68c3cd4b11ada0c968bcb4ba24",
  "room_id": "18832333",
  "senha": "00",
  "modoCriado": "sem carregamento",
  "room_link": "https://ffshare.garena.com/?region=BR&...",
  "auto_start_min": 5,
  "key_tipo": "key_sala",
  "saldo_restante": 49
}
429 rate limit
{
  "error": "RATE_LIMITED",
  "status": "429",
  "msg": "Aguarde 1.5 segundos entre cada criacao de sala por key",
  "tempo_restante": "1.5"
}

Informações da Sala

Obtém informações detalhadas de uma sala, incluindo jogadores, plataforma (mobile/emulador) e versão do FF.

GET/api/v2/info:room?oauth_key=KEY&sshash=HASH
ParâmetroTipoDescrição
oauth_keystring obrigatórioSua key
sshashstring obrigatórioHash da sala (retornado em create:room)
response
{
  "status": "INFO_OBTIDA",
  "room": {
    "id": "18832333",
    "nome": "Salinha728444",
    "modo": 1,
    "estado": "ESPERANDO_COMECAR",
    "created_at": "2026-07-07 18:44:27"
  },
  "players": [
    {
      "id": "1234567890",
      "nickname": "Player1",
      "plataforma": "mobile",
      "versao_ff": "OB54",
      "emulator_score": 0,
      "team": 1,
      "slot": 1
    }
  ],
  "totalPlayers": 1
}

Campos dos Jogadores

ParâmetroTipoDescrição
idstring opcionalUID do jogador
nicknamestring opcionalNome do jogador
plataformastring opcionalmobile, emulator ou desconhecido
versao_ffstring opcionalVersão do Free Fire (ex: OB54)
emulator_scorenumber opcionalScore de emulador (0-100, quanto maior mais provável)
teamnumber opcionalNúmero do time (1 ou 2)
slotnumber opcionalPosição do jogador na sala (1-8)
Dica: emulator_score acima de 50 indica alta probabilidade de emulador. 0-20 geralmente é mobile.

Iniciar Sala

Inicia a partida de uma sala que está esperando jogadores.

GET/api/v2/start:room?oauth_key=KEY&sshash=HASH
response
{
  "status": "PARTIDA_INICIADA",
  "msg": "Partida comecou!",
  "success": "ok"
}

Verificar Sala

Obtém o status atual da sala e informações sobre a partida.

GET/api/v2/check:room?oauth_key=KEY&sshash=HASH
response
{
  "status_atual": "COMECANDO",
  "roomId": "18851079",
  "totalPlayers": 0,
  "bot_conectado": true,
  "partida_iniciada": false
}

Expulsar Jogador

Remove um jogador específico da sala usando seu accountid (UID). Útil para remover emuladores ou jogadores indesejados.

GET/api/v2/expulsar-player?oauth_key=KEY&sshash=HASH&accountid=UID
ParâmetroTipoDescrição
oauth_keystring obrigatórioSua key
sshashstring obrigatórioHash da sala
accountidnumber obrigatórioUID do jogador (obtido em /info:room)
response
{
  "status": "EXPULSO",
  "msg": "Jogador 1234567890 expulso da sala",
  "success": "ok"
}

Exemplo: Expulsar Emuladores

javascript
// 1. Obter info da sala
const info = await fetch('/api/v2/info:room?oauth_key=KEY&sshash=HASH');
const data = await info.json();

// 2. Filtrar emuladores
const emuladores = data.players.filter(p => p.emulator_score > 50);

// 3. Expulsar cada emulador
for (const emu of emuladores) {
  await fetch(`/api/v2/expulsar-player?oauth_key=KEY&sshash=HASH&accountid=${emu.id}`);
  console.log(`Expulso: ${emu.nickname}`);
}

Códigos de Erro

CódigoErrorDescrição
400KEY_OBRIGATORIAParâmetro oauth_key não foi fornecido
401KEY_INVALIDAA key fornecida não existe no sistema
403KEY_INATIVAA key está desativada ou bloqueada
403KEY_TIPO_INVALIDOApenas Key Mãe ou Key de Sala podem criar salas
403SALDO_INSUFICIENTEA key de sala não possui saldo suficiente
403LIMITE_EXCEDIDOA key atingiu o limite de salas permitidas
429RATE_LIMITEDAguarde 2 segundos entre cada criação
400MODO_INVALIDOO modo de sala informado não é 1, 2, 3, 4, 5 ou 6
400SENHA_INVALIDAA senha contém caracteres não numéricos
404SSHASH_INVALIDOO identificador da sala não foi encontrado
503SEM_CONTAS_DISPONIVEISNenhuma conta de bot disponível no momento
503BOT_DESCONECTADOO bot está reconectando, tente novamente
503BRIDGE_OFFLINEServiço interno indisponível
error example
{
  "error": "SALDO_INSUFICIENTE",
  "msg": "A key de sala nao possui saldo suficiente",
  "saldo_atual": 0
}

Precisa de ajuda para integrar?