POST /forgettech/{player_identifier}
Конечная точка: POST /v1/pdapi/forgettech/<player_identifier>
Аутентификация: Токен носителя
Разрешение: REST.Techs.Forget
Цель
Забывает одну, несколько или все технологии игрока.
Параметры пути
player_identifier:UserIdилиPlayerUIDдля целевого игрока.
Параметры запроса
Нет.
Тело запроса
Technology может быть одним TechID, string "All" или array значений TechID. Не помещайте "All" внутрь array.
Схема ответа
200 response schema
| Field | Type | Description |
|---|---|---|
ForgottenCount |
integer | Number of technologies removed from the player. |
Forgotten |
string[] or string | Removed technology IDs, or All when every unlocked technology was removed. |
Skipped |
string[] | Technology IDs skipped because they were not unlocked. |
Реакции на ошибки
Тела ошибок используют следующую форму:
| HTTP | Код ошибки | Когда это произойдет |
|---|---|---|
401 |
INVALID_TOKEN |
Заголовок Authorization отсутствует, имеет неправильный формат или не соответствует настроенному токену носителя. |
403 |
MISSING_PERMISSION |
Токен действителен, но не включает это разрешение конечной точки. |
400 |
INVALID_JSON |
Текст запроса был предоставлен, но его не удалось проанализировать как JSON. |
400 |
REQUEST_FAILED |
Обратный вызов игрового потока вызвал исключение, или произошел сбой общего преобразователя player/resource. |
500 |
REQUEST_TIMEOUT |
Обратный вызов внутреннего игрового потока не завершился в течение 5 секунд. |
400 |
INVALID_REQUEST |
Technology отсутствует или не является string/array в ожидаемом формате. |
400 |
VALIDATION_FAILED |
Technology array содержит не-string, All или неверный технологический идентификатор. |
Примеры
Забудьте одну технологию для игрока GDK
Забудьте о некоторых технологиях PlayerUID
Забудьте все технологии для игрока Steam
Сценарии
- Удалить технологию, предоставленную по ошибке.
- Сбросьте тестовую учетную запись с помощью
"All". - Подтвердите текущее состояние с помощью GET /techs до и после запроса.