📖 Documentação da API

Referência completa para integração com a API de salas do Vortex FF. Crie salas, gerencie jogadores, inicie partidas e muito mais.

URL Base

Copiarhttps://SEU_DOMINIO/api

Todas as requisições e respostas usam JSON. Em rotas com body, envie Content-Type: application/json.

🛡️ Autenticação

Todas as rotas exigem autenticação. Envie seu token Vortex FF no header de autorização:

CopiarAuthorization: Bearer SEU_TOKEN

Seu token é do tipo saldo (consome crédito por sala) ou infinito (salas ilimitadas). Veja o saldo em GET /balance.

POST/rooms

Cria uma sala personalizada no Free Fire. Consome 1 crédito (tokens com saldo).

Copiar{ "password": "123456", // obrigatório (1-16 chars) "start_delay_minutes": 10, // obrigatório (3-10) "config_type": "ap_padrao", // opcional: ap_padrao, gelo_inf, tatico, ap_fullcapa, capa_3, ap_uxd "room_name": "Sala Teste" // opcional }

Resposta

{ "session_id": "9784c0c6dc72...", "room_id": 947072, "password": "123456", "status": "active", "invite_link": "https://ffshare.garena.com/...", "expires_at": "2026-04-08T21:43:25Z" }
GET/rooms/{session_id}

Consulta o status da sessão/sala. 404 se a sessão não existir mais. status: active (aguardando start) ou started (partida iniciada).

GET/rooms/{session_id}/members

Lista os jogadores reais dentro da sala em tempo real. Cada jogador tem team, slot (1-8) e platform (mobile/emulator). O dono (bot) não é incluído.

POST/rooms/{session_id}/kick

Expulsa um jogador. A sessão precisa estar active. Não é permitido expulsar o dono.

{ "player_uid": 1234567890 }
POST/rooms/{session_id}/start

Inicia a partida manualmente. A sessão passa para started e permanece consultável por ~1 minuto.

POST/rooms/{session_id}/release

Encerra a sala e libera a sessão/conta. Após o encerramento a sessão é deletada.

GET/stats/tc?ids={id1},{id2}

Estatísticas Total Competitive de um ou mais jogadores (UIDs separados por vírgula).

{ "results": [ { "account_id": 1705236910, "matches": 33, "wins": 23, "kills": 5, "mvp": 27 } ] }
GET/balance

Retorna o saldo, tipo de plano e informações do token autenticado.

{ "user_id": "abc123", "plan_type": "credit", // ou "infinite" "credit": { "balance": 29.97, "total_spent": 0.03 }, "cost_per_room": 0.03, "rooms_created": 12 }

⚠️ Códigos de Erro

CódigoSignificado
401Token ausente ou inválido
402Saldo insuficiente
403Token desabilitado ou sem permissão
404Sessão não encontrada
409Ação inválida para o estado da sala
422Payload inválido
429Limite de requisições excedido
503Falha operacional