📘 SoulShive Network SDK
Documentație completă API v1 — comună pentru CS 1.6, CS2, SA:MP și FiveM
🚀 Instalare în 2 minute
- Adaugă-ți serverul din Adaugă server (gratuit, fără cont necesar)
- Cheia API îi este generată automat — o vezi pe pagina serverului tău (buton 🔑 Cheie API)
- Descarcă plugin-ul potrivit din Aplicații (opțional — vezi nota de mai sus)
- Pune cheia în config (soulshive.cfg / SoulShiveConfig.json / soulshive.ini)
- Repornește serverul — apare automat ONLINE pe site
🔄 Actualizare plugin
Fiecare heartbeat verifică automat
plugin_latest_version din setări.
Dacă versiunea instalată e mai veche, adminul serverului vede în consolă:
[SoulShive] Actualizare disponibila - vezi soulshive.com/apps.php
📡 Endpoint-uri API v1
| METODĂ | ENDPOINT | SCOP |
|---|
| POST | /api/v1/register.php | Înregistrare/actualizare server (o dată, la pornire) |
| POST | /api/v1/heartbeat.php | Status live: jucători, hartă, versiune, uptime — la 60s |
| GET | /api/v1/redirect.php | Cere un server liber din rețea (prioritate: boost → cel mai liber) |
| GET | /api/v1/server.php | Configurația curentă a serverului (boost, redirect activ) |
| GET | /api/v1/stats.php | Statistici rapide pentru /servers în joc |
| POST | /api/v1/player/connect.php | SteamID + nume la conectare |
| POST | /api/v1/player/disconnect.php | SteamID la deconectare |
| POST | /api/v1/logs.php | Evenimente libere (redirect, erori, actualizări) |
🔑 Autentificare
Fiecare request trimite
api_key (obligatoriu) și, opțional,
ts +
sig pentru semnătură HMAC:
sig = sha1(api_key + ":" + ts)
Semnătura e validată doar dacă e trimisă — pluginurile vechi fără ea continuă să funcționeze. Requesturile sunt limitate la 1 per 0.5s per cheie (rate limiting anti-abuz).
📦 Răspuns tipic (heartbeat)
{
"ok": true,
"server_id": 42,
"boost": true,
"boost_tier": "gold",
"boost_priority": 75,
"is_partner": false,
"redirect": false,
"update": false,
"latest_version": "3.2"
}
