Der Squad-Reiter braucht kein Konto mehr: Spielername eingeben, der PC
bekommt einen Schluessel (Token ohne Ablauf), die Akten werden fuer alle
sichtbar. E-Mail und Passwort sind optional ("Konto sichern") und machen
die Charaktere reset- und mehr-PC-fest. Ohne gesichertes Konto bietet das
Menue kein Abmelden, weil das den Schluessel loeschte.
Server: Aktionen mitmachen und konto_sichern, Konten ohne E-Mail
(Datenbank-Stand 2, eingespielt von DB::migrieren() bei der ersten
Anfrage), Loeschen ohne Passwort fuer reine Schluessel-Konten, Verwaltung
zeigt sie als "nur Schluessel". Deinstallationsfrage nennt den Schluessel.
Tests: Server 108, Zwei-PC 34, Oberflaeche 24 - auch gegen das Paket.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
174 lines
8.5 KiB
PHP
174 lines
8.5 KiB
PHP
<?php
|
|
/*
|
|
* Schnittstelle fuer das Programm.
|
|
*
|
|
* Alle Aufrufe: POST /api/ mit JSON {"aktion": "...", ...}. Angemeldete
|
|
* Aufrufe schicken das Sitzungstoken im Kopf X-SM-Token - nicht in
|
|
* Authorization, das Plesk-Konfigurationen gern verschlucken. Antwort immer
|
|
* JSON: {"ok": true, ...} oder {"ok": false, "fehler": "code", "meldung": "Text"}.
|
|
*/
|
|
declare(strict_types=1);
|
|
|
|
final class Api
|
|
{
|
|
private const OHNE_ANMELDUNG = ['status', 'mitmachen', 'registrieren', 'anmelden', 'bestaetigung_erneut',
|
|
'passwort_vergessen'];
|
|
private const MAX_ANFRAGE_BYTES = 12 * 1024 * 1024;
|
|
|
|
private static function senden(array $daten, int $http = 200): never
|
|
{
|
|
http_response_code($http);
|
|
header('Content-Type: application/json; charset=utf-8');
|
|
header('Cache-Control: no-store');
|
|
header('X-Content-Type-Options: nosniff');
|
|
echo json_encode($daten, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES);
|
|
exit;
|
|
}
|
|
|
|
private static function text(array $anfrage, string $feld, int $max = 1000): string
|
|
{
|
|
$wert = $anfrage[$feld] ?? '';
|
|
if (!is_string($wert) && !is_int($wert)) {
|
|
throw new SmFehler('feld_ungueltig', "Feld $feld ist ungültig.");
|
|
}
|
|
return mb_substr((string) $wert, 0, $max);
|
|
}
|
|
|
|
private static function zahl(array $anfrage, string $feld): int
|
|
{
|
|
$wert = $anfrage[$feld] ?? null;
|
|
if (!is_int($wert) && !(is_string($wert) && ctype_digit($wert))) {
|
|
throw new SmFehler('feld_ungueltig', "Feld $feld fehlt oder ist keine Zahl.");
|
|
}
|
|
return (int) $wert;
|
|
}
|
|
|
|
public static function behandeln(): never
|
|
{
|
|
try {
|
|
if (($_SERVER['REQUEST_METHOD'] ?? '') !== 'POST') {
|
|
throw new SmFehler('methode', 'Nur POST.', 405);
|
|
}
|
|
$roh = file_get_contents('php://input', false, null, 0, self::MAX_ANFRAGE_BYTES + 1);
|
|
if ($roh === false || strlen($roh) > self::MAX_ANFRAGE_BYTES) {
|
|
throw new SmFehler('anfrage_zu_gross', 'Die Anfrage ist zu groß.', 413);
|
|
}
|
|
DB::migrieren();
|
|
$anfrage = json_decode($roh, true);
|
|
if (!is_array($anfrage) || !is_string($anfrage['aktion'] ?? null)) {
|
|
throw new SmFehler('anfrage_ungueltig', 'Ungültige Anfrage.');
|
|
}
|
|
$aktion = $anfrage['aktion'];
|
|
|
|
$nutzer = null;
|
|
if (!in_array($aktion, self::OHNE_ANMELDUNG, true)) {
|
|
$nutzer = Sicherheit::sitzung((string) ($_SERVER['HTTP_X_SM_TOKEN'] ?? ''));
|
|
if ($nutzer === null) {
|
|
throw new SmFehler('nicht_angemeldet', 'Bitte melde dich an.', 401);
|
|
}
|
|
}
|
|
self::senden(['ok' => true] + self::ausfuehren($aktion, $anfrage, $nutzer));
|
|
} catch (SmFehler $fehler) {
|
|
self::senden(['ok' => false, 'fehler' => $fehler->fehlercode, 'meldung' => $fehler->getMessage()]
|
|
+ $fehler->extra, $fehler->http);
|
|
} catch (Throwable $fehler) {
|
|
sm_log('API: ' . $fehler::class . ': ' . $fehler->getMessage() . ' in '
|
|
. $fehler->getFile() . ':' . $fehler->getLine());
|
|
self::senden(['ok' => false, 'fehler' => 'serverfehler',
|
|
'meldung' => 'Auf dem Server ist ein Fehler aufgetreten.'], 500);
|
|
}
|
|
}
|
|
|
|
private static function ausfuehren(string $aktion, array $a, ?array $nutzer): array
|
|
{
|
|
switch ($aktion) {
|
|
case 'status':
|
|
return ['api' => SM_API_VERSION, 'zeit' => DB::jetzt()];
|
|
|
|
// -- Konto ------------------------------------------------------
|
|
case 'mitmachen':
|
|
return Konten::mitmachen(self::text($a, 'spielername', 64), self::text($a, 'geraet', 100));
|
|
case 'konto_sichern':
|
|
return ['nutzer' => Konten::kontoSichern($nutzer, self::text($a, 'email', 250),
|
|
self::text($a, 'passwort', 500)),
|
|
'meldung' => 'Wir haben dir eine Mail zur Bestätigung geschickt.'];
|
|
case 'registrieren':
|
|
Konten::registrieren(self::text($a, 'benutzername', 64), self::text($a, 'email', 250),
|
|
self::text($a, 'passwort', 500));
|
|
return ['meldung' => 'Konto angelegt. Wir haben dir eine Mail zur Bestätigung geschickt.'];
|
|
case 'bestaetigung_erneut':
|
|
Konten::bestaetigungErneut(self::text($a, 'email', 250));
|
|
return ['meldung' => 'Falls ein unbestätigtes Konto zu dieser Adresse gehört, ist die Mail unterwegs.'];
|
|
case 'anmelden':
|
|
return Konten::anmelden(self::text($a, 'login', 250), self::text($a, 'passwort', 500),
|
|
self::text($a, 'geraet', 100));
|
|
case 'passwort_vergessen':
|
|
Konten::passwortVergessen(self::text($a, 'email', 250));
|
|
return ['meldung' => 'Falls ein Konto zu dieser Adresse gehört, ist die Mail unterwegs.'];
|
|
case 'abmelden':
|
|
Konten::abmelden($nutzer);
|
|
return [];
|
|
case 'ich':
|
|
return ['nutzer' => Konten::oeffentlich($nutzer)];
|
|
case 'konto_loeschen':
|
|
Konten::kontoLoeschen($nutzer, self::text($a, 'passwort', 500));
|
|
return [];
|
|
|
|
// -- Eigene Charaktere -------------------------------------------
|
|
case 'charaktere_eigene':
|
|
return ['charaktere' => Charaktere::eigene($nutzer)];
|
|
case 'charakter_speichern':
|
|
$basis = $a['basis_version'] ?? null;
|
|
return ['charakter' => Charaktere::speichern($nutzer, self::text($a, 'lokale_id', 64),
|
|
$a['daten'] ?? null, is_int($basis) ? $basis : null, ($a['erzwingen'] ?? false) === true)];
|
|
case 'charakter_loeschen':
|
|
Charaktere::loeschen($nutzer, self::text($a, 'lokale_id', 64));
|
|
return [];
|
|
case 'portraet_hochladen':
|
|
return ['charakter' => Charaktere::portraetSetzen($nutzer, self::text($a, 'lokale_id', 64),
|
|
self::text($a, 'bild', self::MAX_ANFRAGE_BYTES))];
|
|
case 'portraet_entfernen':
|
|
return ['charakter' => Charaktere::portraetEntfernen($nutzer, self::text($a, 'lokale_id', 64))];
|
|
|
|
// -- Alle Charaktere ---------------------------------------------
|
|
case 'charaktere_alle':
|
|
return ['charaktere' => Charaktere::alle($nutzer, self::text($a, 'suche', 64),
|
|
self::text($a, 'fraktion', 80))];
|
|
case 'charakter_ansehen':
|
|
return ['charakter' => Charaktere::ansehen($nutzer, self::zahl($a, 'id'))];
|
|
|
|
// -- Squads -------------------------------------------------------
|
|
case 'squads':
|
|
return ['squads' => Squads::liste($nutzer)];
|
|
case 'squad_ansehen':
|
|
return ['squad' => Squads::details($nutzer, self::zahl($a, 'squad_id'))];
|
|
case 'squad_gruenden':
|
|
return ['squad' => Squads::gruenden($nutzer, self::zahl($a, 'charakter_id'),
|
|
self::text($a, 'name', 100), self::text($a, 'beschreibung', 2000))];
|
|
case 'squad_einladen':
|
|
return ['einladung' => Squads::einladen($nutzer, self::zahl($a, 'squad_id'),
|
|
self::zahl($a, 'charakter_id'))];
|
|
case 'einladungen':
|
|
return Squads::einladungen($nutzer);
|
|
case 'einladung_beantworten':
|
|
Squads::beantworten($nutzer, self::zahl($a, 'einladung_id'), ($a['annehmen'] ?? false) === true);
|
|
return [];
|
|
case 'einladung_zurueckziehen':
|
|
Squads::zurueckziehen($nutzer, self::zahl($a, 'einladung_id'));
|
|
return [];
|
|
case 'squad_verlassen':
|
|
Squads::verlassen($nutzer, self::zahl($a, 'charakter_id'));
|
|
return [];
|
|
case 'squad_entfernen':
|
|
Squads::entfernen($nutzer, self::zahl($a, 'squad_id'), self::zahl($a, 'charakter_id'));
|
|
return [];
|
|
case 'squad_fuehrung_uebergeben':
|
|
Squads::fuehrungUebergeben($nutzer, self::zahl($a, 'squad_id'), self::zahl($a, 'charakter_id'));
|
|
return [];
|
|
case 'squad_aufloesen':
|
|
Squads::aufloesen($nutzer, self::zahl($a, 'squad_id'));
|
|
return [];
|
|
}
|
|
throw new SmFehler('aktion_unbekannt', 'Unbekannte Aktion.', 404);
|
|
}
|
|
}
|