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.
A GUCCIFER API permite criar e gerenciar salas de forma automatizada. O sistema utiliza dois tipos principais de autenticação:
Todas as rotas que criam salas exigem uma Key Mãe ou Key de Sala válida no parâmetro oauth_key.
A Key Mãe é ilimitada e permite criar Keys de Sala e Seriais. Formato: GUCCIFER-INFINITY-XXXXXXXX.
GET https://guccifersalas.online/infokey?key=GUCCIFER-INFINITY-ABC12345{
"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"
}Keys com saldo limitado para criar salas. Formato: GUCCIFER-QTD-XXXXXXXX (ex: GUCCIFER-100-ABC123).
| Parâmetro | Tipo | Descrição |
|---|---|---|
| keymae | string obrigatório | Sua Key Mãe (GUCCIFER-INFINITY-...) |
| quantidadekey | int obrigatório | Quantidade de keys a criar |
| quantidadesala | int obrigatório | Saldo de salas por key (1-10000) |
GET https://guccifersalas.online/criarkeysala?keymae=GUCCIFER-INFINITY-ABC123&quantidadekey=1&quantidadesala=100{
"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"
]
}| Parâmetro | Tipo | Descrição |
|---|---|---|
| key | string obrigatório | Key Mãe ou Key de Sala para consultar |
GET https://guccifersalas.online/infokey?key=GUCCIFER-100-XY7Z9A2B{
"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"
}| Parâmetro | Tipo | Descrição |
|---|---|---|
| keymae | string obrigatório | Sua Key Mãe (só pode deletar keys criadas por ela) |
| keysala | string obrigatório | Key de Sala a ser deletada |
{
"success": true,
"msg": "Key de Sala bloqueada/deletada com sucesso",
"keysala": "GUCCIFER-100-XY7Z9A2B",
"keymae": "GUCCIFER-INFINITY-ABC123"
}Códigos únicos para resgate. Formato: GUCCIFER-QTD-XXXXXXXX.
| Parâmetro | Tipo | Descrição |
|---|---|---|
| keymae | string obrigatório | Sua Key Mãe |
| quantidade | int obrigatório | Quantidade de seriais (1-100) |
| saldo | int obrigatório | Saldo de cada serial |
{
"success": true,
"msg": "1 seriais criados com sucesso",
"keymae": "GUCCIFER-INFINITY-ABC123",
"quantidade": 1,
"valor_cada": 5,
"total_valor": 5,
"seriais": [
"GUCCIFER-5-ED6BE6MR"
]
}| Parâmetro | Tipo | Descrição |
|---|---|---|
| seriais | string obrigatório | Código(s) do serial (separados por vírgula) |
| keysala | string obrigatório | Key de Sala para receber o saldo |
{
"success": true,
"keysala": "GUCCIFER-100-XY7Z9A2B",
"saldo_anterior": 100,
"saldo_adicionado": 5,
"novo_saldo": 105,
"codigos_resgatados": ["GUCCIFER-5-ABC123"],
"codigos_nao_resgatados": []
}Cria uma nova sala com configurações específicas. Requer Key Mãe ou Key de Sala.
| Parâmetro | Tipo | Descrição |
|---|---|---|
| oauth_key | string obrigatório | Key Mãe ou Key de Sala |
| modo | int obrigatório | Modo da sala (1-6) |
| senha | string opcional | Senha da sala |
| auto_start_min | int opcional | Minutos para iniciar automaticamente (padrão: 5, use 0 para manual) |
GET https://guccifersalas.online/api/v1/create:room?oauth_key=GUCCIFER-50-XY7Z9A2B&modo=3&senha=00{
"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
}{
"error": "RATE_LIMITED",
"status": "429",
"msg": "Aguarde 1.5 segundos entre cada criacao de sala por key",
"tempo_restante": "1.5"
}Obtém informações detalhadas de uma sala, incluindo jogadores, plataforma (mobile/emulador) e versão do FF.
| Parâmetro | Tipo | Descrição |
|---|---|---|
| oauth_key | string obrigatório | Sua key |
| sshash | string obrigatório | Hash da sala (retornado em create:room) |
{
"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
}| Parâmetro | Tipo | Descrição |
|---|---|---|
| id | string opcional | UID do jogador |
| nickname | string opcional | Nome do jogador |
| plataforma | string opcional | mobile, emulator ou desconhecido |
| versao_ff | string opcional | Versão do Free Fire (ex: OB54) |
| emulator_score | number opcional | Score de emulador (0-100, quanto maior mais provável) |
| team | number opcional | Número do time (1 ou 2) |
| slot | number opcional | Posição do jogador na sala (1-8) |
Inicia a partida de uma sala que está esperando jogadores.
{
"status": "PARTIDA_INICIADA",
"msg": "Partida comecou!",
"success": "ok"
}Obtém o status atual da sala e informações sobre a partida.
{
"status_atual": "COMECANDO",
"roomId": "18851079",
"totalPlayers": 0,
"bot_conectado": true,
"partida_iniciada": false
}Remove um jogador específico da sala usando seu accountid (UID). Útil para remover emuladores ou jogadores indesejados.
| Parâmetro | Tipo | Descrição |
|---|---|---|
| oauth_key | string obrigatório | Sua key |
| sshash | string obrigatório | Hash da sala |
| accountid | number obrigatório | UID do jogador (obtido em /info:room) |
{
"status": "EXPULSO",
"msg": "Jogador 1234567890 expulso da sala",
"success": "ok"
}// 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ódigo | Error | Descrição |
|---|---|---|
| 400 | KEY_OBRIGATORIA | Parâmetro oauth_key não foi fornecido |
| 401 | KEY_INVALIDA | A key fornecida não existe no sistema |
| 403 | KEY_INATIVA | A key está desativada ou bloqueada |
| 403 | KEY_TIPO_INVALIDO | Apenas Key Mãe ou Key de Sala podem criar salas |
| 403 | SALDO_INSUFICIENTE | A key de sala não possui saldo suficiente |
| 403 | LIMITE_EXCEDIDO | A key atingiu o limite de salas permitidas |
| 429 | RATE_LIMITED | Aguarde 2 segundos entre cada criação |
| 400 | MODO_INVALIDO | O modo de sala informado não é 1, 2, 3, 4, 5 ou 6 |
| 400 | SENHA_INVALIDA | A senha contém caracteres não numéricos |
| 404 | SSHASH_INVALIDO | O identificador da sala não foi encontrado |
| 503 | SEM_CONTAS_DISPONIVEIS | Nenhuma conta de bot disponível no momento |
| 503 | BOT_DESCONECTADO | O bot está reconectando, tente novamente |
| 503 | BRIDGE_OFFLINE | Serviço interno indisponível |
{
"error": "SALDO_INSUFICIENTE",
"msg": "A key de sala nao possui saldo suficiente",
"saldo_atual": 0
}Fale comigo diretamente por qualquer um dos canais abaixo: