FiveMobileFiveMobile

API da plataforma

Base: https://api.fivemobile.online. Respostas em JSON.

Listar servidores (ranking)

GET /v1/servidores?idioma=pt

idioma é opcional (ru, pt, en, id, es). Ordem: online primeiro, depois jogadores e votos.

{
  "servidores": [
    {
      "slug": "meu-servidor",
      "nome": "Meu Servidor RP",
      "idioma": "pt",
      "tags": ["rp"],
      "online": true,
      "jogadores": 42,
      "maxJogadores": 128,
      "picoJogadores": 97,
      "votos": 0
    }
  ]
}

Um servidor

GET /v1/servidores/{slug}

Sinal de vida

Usado pelo recurso fivemobile_plataforma; você só precisa disto se for escrever a sua própria integração.

POST /v1/servidores/sinal
Authorization: Bearer fm_srv_...
Content-Type: application/json

{ "jogadores": 42, "maxJogadores": 128, "porta": 22030, "versao": "1.0.0" }

Resposta: { "ok": true, "proximoEm": 30 }: mande o próximo sinal em até proximoEm segundos. Sem sinal por 90 segundos, o servidor aparece como offline.

Código Erro Motivo
401 chave_invalida chave ausente ou incorreta
403 servidor_pendente / servidor_suspenso servidor não aprovado
400 — corpo fora do formato

Em breve

Login de jogadores, ticket de entrada (só jogadores autenticados entram em servidores da plataforma) e a API da loja dos servidores.