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.