Documentação oficial

Referência completa da API de Salas

Área dedicada para integração com exemplos de requisição, respostas e fluxos de autenticação.

Ver Endpoints Ir ao Dashboard

Documentação da API

Referência completa para integração com a API SalasBot FF

Base URL Todas as requisições devem ser feitas para: https://salas-bot.freefireapi.online

A API permite criar salas do jogo Free Fire de forma automática, ótimo para mediadores e orgs de Free Fire! Todos os endpoints aceitam requisições GET e POST, retornando respostas em formato JSON.

Autenticação

A API aceita dois métodos de autenticação. No GET, passe a key como parâmetro na URL. No POST, envie a key pelo header Authorization e os demais parâmetros no body JSON.

Via GET (query string) 
GET /api/v1/status?oauth_key=SALABOT-ABCD1234EFGH5678
Via POST (Authorization header) 
POST /api/v1/status
Content-Type: application/json
Authorization: SALABOT-ABCD1234EFGH5678
Importante Mantenha sua oauth_key em segredo. Não compartilhe ou exponha em código público. No POST, você também pode usar o formato Bearer SUA_KEY no header Authorization.

Códigos de Erro

Código Error Descrição
401 KEY_INVALIDA A key fornecida não existe no sistema
401 KEY_INATIVA A key existe mas está desativada
401 LIMITE_EXCEDIDO A key atingiu o limite de salas permitidas
503 SEM_CONTAS_DISPONIVEIS Nenhuma conta de bot disponível no momento
503 BOT_DESCONECTOU O bot está reconectando, tente novamente
404 SSHASH_INVALIDO O identificador da sala não foi encontrado
400 MODO_INVALIDO O modo de sala informado não é 1, 2, 3, 4 ou 5
400 SENHA_INVALIDA A senha da sala contém caracteres não numéricos
429 RATE_LIMITED Aguarde 1.2 segundos entre cada criação de sala por key

Endpoints

GET POST /api/verificar-key Verifica informações da sua key

Parâmetros

Nome Tipo Obrigatório Descrição
oauth_key string Sim Sua chave de autenticação (GET: query string / POST: header Authorization)

Exemplos

GET 
GET /api/verificar-key?oauth_key=SALABOT-ABCD1234EFGH5678
POST 
POST /api/verificar-key
Authorization: SALABOT-ABCD1234EFGH5678

Respostas

Sucesso 200 OK 
{
    "sucesso": true,
    "key": "SALABOT-ABCD1234EFGH5678",
    "nome": "Minha Key",
    "ativa": true,
    "limite_usos": 100,
    "usos_totais": 25,
    "usos_restantes": 75,
    "criada_em": "2026-01-28 15:30:00",
    "ultima_request": "2026-01-30 10:45:22",
    "discord_id": "123456789012345678"
}
GET POST /api/status Status geral do sistema (compatível com /api/v1/status)

Respostas

Sucesso 200 OK 
{
    "status": "OK",
    "total_contas": 10,
    "contas_online": 8,
    "contas_disponiveis": 5,
    "total_salas_criadas": 3770,
    "contas": [
        {
            "account_id": "12345",
            "nickname": "Bot_Sala_01",
            "online": true,
            "em_sala": true,
            "chat_conectado": true
        }
    ]
}
GET POST /api/v1/create:room Cria uma nova sala

Parâmetros

Nome Tipo Obrigatório Descrição
oauth_key string Sim Sua chave (GET: query string / POST: header Authorization)
modo integer Sim 1 (sem carregamento), 2 (com equipamento), 3 (1x1 gel inf), 4 (full capa), 5 (capa nv3 sem carreg)
senha string Não Senha numérica para a sala
nome string Não Nome da sala (default: Salinha123)
auto_start integer Não Início automático da sala em minutos (1 a 8). Também aceita auto_start_min.

Exemplos

GET - com auto start opcional 
GET /api/v1/create:room?oauth_key=SUA_KEY&modo=2&senha=123&nome=MinhaSala&auto_start=5
POST - com auto start opcional 
POST /api/v1/create:room
Authorization: SUA_KEY
Content-Type: application/json

{"modo": 2, "senha": "123", "nome": "MinhaSala", "auto_start": 5}

Respostas

Sucesso 200 OK 
{
    "status": "SALA_CRIADA",
    "msg": "sala criada com exito!",
    "roomId": "12345678",
    "sshash": "abcdef123456",
    "senha": "123",
    "nome": "Minha Sala",
    "modoCriado": "com carregamento"
}
Rate Limited 429 Too Many Requests 
{
    "status": "RATE_LIMITED",
    "msg": "Aguarde 1.2 segundos entre cada criação de sala."
}
Rate Limit Cada key pode criar no máximo 1 sala a cada 1.2 segundos. Requisições acima desse limite retornarão erro 429.
GET POST /api/v2/info:room Obtém informações de uma sala

Parâmetros

Nome Tipo Obrigatório Descrição
oauth_key string Sim Sua chave (GET: query string / POST: header Authorization)
sshash string Sim Identificador único da sala (GET: query string / POST: body JSON)

Respostas

Sucesso 200 OK 
{
    "status": "INFO_OBTIDA",
    "room": {
        "id": "12345678",
        "nome": "Minha Sala",
        "modo": 2,
        "senha": "123",
        "estado": "ESPERANDO_COMECAR",
        "created_at": "2026-01-30 12:00:00"
    },
    "infoGroups": [
        {
            "teamIndex": 1,
            "teamLabel": "Time 1 (Esquerda)",
            "players": [
                {
                    "slot": 2,
                    "playerID": "14556436741",
                    "nickname": "sistemasloko",
                    "ready": true,
                    "playerPlatform": "Emulador"
                }
            ],
            "totalPlayers": 1
        },
        {
            "teamIndex": 2,
            "teamLabel": "Time 2 (Direita)",
            "players": [
                {
                    "slot": 2,
                    "playerID": "14063022871",
                    "nickname": "Gus8x7W4x",
                    "ready": true,
                    "playerPlatform": "Mobile"
                }
            ],
            "totalPlayers": 1
        }
    ],
    "totalPlayers": 2
}
GET POST /api/v2/start:room Inicia a partida de uma sala

Parâmetros

Nome Tipo Obrigatório Descrição
oauth_key string Sim Sua chave (GET: query string / POST: header Authorization)
sshash string Sim Identificador único da sala (GET: query string / POST: body JSON)
enviar_msg boolean Não Envia contagem regressiva no chat da sala antes de iniciar. Padrão: true. Use false para iniciar sem mensagens.

Exemplos

GET - com mensagem (padrao) 
GET /api/v2/start:room?oauth_key=SUA_KEY&sshash=HASH_DA_SALA
POST - sem mensagem 
POST /api/v2/start:room
Authorization: SUA_KEY
Content-Type: application/json

{"sshash": "HASH_DA_SALA", "enviar_msg": "false"}

Respostas

Sucesso 200 OK 
{
    "status": "PARTIDA_INICIADA",
    "msg": "Partida começou!",
    "success": "ok"
}
GET POST /api/v2/check:room Verifica o estado de uma sala

Parâmetros

Nome Tipo Obrigatório Descrição
oauth_key string Sim Sua chave (GET: query string / POST: header Authorization)
sshash string Sim Identificador único da sala (GET: query string / POST: body JSON)

Respostas

Sucesso 200 OK 
{
    "status_atual": "SALA_INICIADA",
    "roomId": "12345678",
    "totalPlayers": 1,
    "lastUpdate": 1675094400,
    "bot_conectado": true,
    "partida_iniciada": true,
    "partida_iniciada_manualmente": false,
    "partida_iniciada_timestamp": 1675094400
}
GET POST /api/v2/expulsar-player Expulsa um jogador da sala

Parâmetros

Nome Tipo Obrigatório Descrição
oauth_key string Sim Sua chave (GET: query string / POST: header Authorization)
sshash string Sim Identificador único da sala (GET: query string / POST: body JSON)
accountid number Sim ID da conta do jogador (GET: query string / POST: body JSON)

Respostas

Sucesso 200 OK 
{
    "status": "EXPULSO",
    "msg": "Jogador 12345678 expulso da sala",
    "success": "ok"
}
Erro 400 Bad Request 
{
    "status": "ERRO",
    "msg": "Falha ao expulsar"
}
GET POST /api/info-system Retorna informações do sistema (compatível com /api/v1/info-system)

Respostas

Sucesso 200 OK 
{
    "status": "OK",
    "bots_online": 5,
    "bots_total": 10,
    "uptime": "2h 30m 15s",
    "taxa_sucesso_bot": 95.77,
    "taxa_sucesso_api": 98.50,
    "bot_ok": true,
    "api_ok": true
}

Campos da Resposta

Campo Tipo Descrição
bots_online number Quantidade de bots conectados
bots_total number Total de bots disponíveis
uptime string Tempo de atividade do sistema
taxa_sucesso_bot number Porcentagem de sucesso do bot
taxa_sucesso_api number Porcentagem de sucesso da API
bot_ok boolean Se o bot está funcionando
api_ok boolean Se a API está funcionando