SPONSORIZAT

📘 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"
}

⬇ Download Center

CS 1.6 (.sma) CS2 (.cs) SA:MP (.pwn) FiveM (resource) Toate aplicațiile →

PARTENERI OFICIALI