Zum Inhalt

POST /deletebase/{base_camp_id}

Endpunkt: POST /v1/pdapi/deletebase/<base_camp_id>

Auth: Bearer-Token

Berechtigung: REST.Base.Delete

Zweck

Löscht eine Basis/ein Camp anhand der Base-Camp-ID. Das ist eine destruktive Admin-Aktion.

Pfadparameter

  • base_camp_id: Kennung des Basislagers, üblicherweise aus Gilden- oder Basisdaten kopiert.

Query-Parameter

Keine.

Request-Body

Optionales leeres JSON-Objekt. Bestätige die ID, bevor du die Anfrage sendest.

Antwortschema

Schema der 200-Antwort

Feld Typ Beschreibung
BaseCamp object Zusammenfassung des gelöschten Basislagers.
Deleted object Bereinigungszahlen der gelöschten Basislagerdaten.
Archive string Pfad zum erstellten Prüfarchiv.

Schema des BaseCamp-Objekts:

Feld Typ Beschreibung
Id string GUID des Basislagers.
Summary string Lesbare Zusammenfassung des Basislagers.

Schema des Deleted-Objekts:

Feld Typ Beschreibung
BaseCampPals integer Anzahl der gelöschten Basislager-Pals.
StorageContainers integer Anzahl der geleerten Lagercontainer.
ItemStacks integer Anzahl der gelöschten Gegenstandsstapel.
ItemCount integer Gesamtzahl der gelöschten Gegenstände.
Buildings integer Anzahl der gelöschten Gebäude.
DropItems integer Anzahl der gelöschten fallengelassenen Gegenstandsakteure.
DefenseModels integer Anzahl der gelöschten Verteidigungsmodelle.
OtherMapObjects integer Anzahl der gelöschten sonstigen Kartenobjekte.
PalBox boolean Gibt an, ob die Palbox der Basis gelöscht wurde.

Fehlerantworten

Fehlerantworten verwenden dieses Format:

{
    "Error": {
        "Code": "ERROR_CODE",
        "Message": "Für Menschen lesbare Nachricht",
        "Details": {}
    }
}
HTTP Fehlercode Wann es passiert
401 INVALID_TOKEN Der Authorization-Header fehlt, ist fehlerhaft oder passt zu keinem konfigurierten Bearer-Token.
403 MISSING_PERMISSION Das Token ist gültig, enthält aber nicht die Berechtigung für diesen Endpunkt.
400 INVALID_JSON Ein Request-Body wurde gesendet, konnte aber nicht als JSON gelesen werden.
400 REQUEST_FAILED Der Game-Thread-Callback hat eine Ausnahme ausgelöst oder ein gemeinsamer Spieler-/Ressourcen-Resolver ist fehlgeschlagen.
500 REQUEST_TIMEOUT Der interne Game-Thread-Callback wurde nicht innerhalb von 5 Sekunden abgeschlossen.
400 INVALID_BASE_CAMP_ID The base_camp_id path value is not a valid GUID.
500 BASE_CAMP_MANAGER_UNAVAILABLE Der Server konnte nicht auf UPalBaseCampManager zugreifen.
404 BASE_CAMP_NOT_FOUND Kein Basislager entsprach der angegebenen GUID.
500 DELETE_BASE_FAILED Das Base Camp wurde gefunden, aber Zerstoerung/Bereinigung ist fehlgeschlagen.

Beispiele

Ein Basislager anhand seiner GUID löschen

POST /v1/pdapi/deletebase/13b9e8d7-4f2c-42a1-b79e-fc2a9186e4d5

Ein weiteres Basislager anhand seiner GUID löschen

POST /v1/pdapi/deletebase/81c2f0a4-6d7e-49fb-a11d-0d2f9f94b13c

Szenarien

  • Verlassene oder defekte Basen nach Prüfung durch das Team entfernen.
  • Nutze GET /guilds und GET /guild, um vor dem Löschen das richtige Camp zu identifizieren.
  • Diesen Endpunkt nicht für routinemäßige Bereinigungen verwenden, sofern der Teamprozess Eigentum und Sicherungen nicht bereits prüft.