POST /deletebase/{base_camp_id}
Punkt końcowy: POST /v1/pdapi/deletebase/<base_camp_id>
Uwierzytelnianie: token Bearer
Wymagane uprawnienie: REST.Base.Delete
Przeznaczenie
Usuwa bazę/obóz według identyfikatora obozu bazowego. Jest to działanie administratora niszczące dane.
Parametry ścieżki
base_camp_id: Identyfikator obozu bazowego, zwykle kopiowany z danych gildii lub bazy.
Parametry zapytania
Brak.
Treść żądania
Opcjonalny pusty obiekt JSON. Sprawdź identyfikator przed wysłaniem żądania.
Schemat odpowiedzi
Schemat odpowiedzi 200
| Pole | Typ | Opis |
|---|---|---|
BaseCamp |
obiekt | Podsumowanie usuniętego obozu bazowego. |
Deleted |
obiekt | Liczby usuniętych elementów danych obozu bazowego. |
Archive |
ciąg znaków | Ścieżka do wygenerowanego archiwum kontroli. |
BaseCamp — schemat obiektu:
| Pole | Typ | Opis |
|---|---|---|
Id |
ciąg znaków | GUID obozu bazowego. |
Summary |
ciąg znaków | Czytelne podsumowanie obozu bazowego. |
Deleted — schemat obiektu:
| Pole | Typ | Opis |
|---|---|---|
BaseCampPals |
liczba całkowita | Liczba usuniętych Pali obozu bazowego. |
StorageContainers |
liczba całkowita | Liczba opróżnionych pojemników magazynowych. |
ItemStacks |
liczba całkowita | Liczba usuniętych stosów przedmiotów. |
ItemCount |
liczba całkowita | Łączna liczba usuniętych sztuk przedmiotów. |
Buildings |
liczba całkowita | Liczba usuniętych budowli. |
DropItems |
liczba całkowita | Liczba usuniętych obiektów wyrzuconych przedmiotów. |
DefenseModels |
liczba całkowita | Liczba usuniętych modeli obronnych. |
OtherMapObjects |
liczba całkowita | Liczba usuniętych pozostałych obiektów mapy. |
PalBox |
wartość logiczna | Czy usunięto Palbox bazy. |
Odpowiedzi błędów
Treść odpowiedzi błędu ma następującą postać:
| HTTP | Kod błędu | Kiedy występuje |
|---|---|---|
401 |
INVALID_TOKEN |
Brakuje nagłówka Authorization, ma on nieprawidłowy format lub nie odpowiada żadnemu skonfigurowanemu tokenowi Bearer. |
403 |
MISSING_PERMISSION |
Token jest prawidłowy, ale nie ma uprawnienia wymaganego przez ten punkt końcowy. |
400 |
INVALID_JSON |
Przesłano treść żądania, ale nie można jej odczytać jako JSON. |
400 |
REQUEST_FAILED |
Funkcja wywołana w wątku gry zgłosiła wyjątek lub wspólny mechanizm wyszukiwania gracza/zasobu zakończył się niepowodzeniem. |
500 |
REQUEST_TIMEOUT |
Wewnętrzna funkcja wywołana w wątku gry nie zakończyła się w ciągu 5 sekund. |
400 |
INVALID_BASE_CAMP_ID |
Wartość base_camp_id w ścieżce nie jest prawidłowym GUID. |
500 |
BASE_CAMP_MANAGER_UNAVAILABLE |
Serwer nie uzyskał dostępu do UPalBaseCampManager. |
404 |
BASE_CAMP_NOT_FOUND |
Nie znaleziono obozu bazowego o podanym GUID. |
500 |
DELETE_BASE_FAILED |
Znaleziono obóz bazowy, ale jego zniszczenie lub usunięcie powiązanych danych nie powiodło się. |
Przykłady
Usunięcie obozu bazowego według GUID
Usunięcie kolejnego obozu bazowego według GUID
Przykładowe zastosowania
- Usuwanie opuszczonych lub uszkodzonych baz po sprawdzeniu przez zespół.
- Przed usunięciem ustal właściwy obóz za pomocą GET /guilds i GET /guild.
- Nie używaj tego punktu końcowego do rutynowego porządkowania, jeśli procedury zespołu nie obejmują weryfikacji właściciela i kopii zapasowych.