POST /give/pals/{player_identifier}
Конечная точка: POST /v1/pdapi/give/pals/<player_identifier>
Аутентификация: Токен носителя
Разрешение: REST.Pals.Give
Цель
Дает один или несколько Pals по идентификатору и уровню.
Параметры пути
player_identifier:UserIdилиPlayerUIDдля целевого игрока.
Параметры запроса
Нет.
Тело запроса
JSON object с Pals, array из Pal грантов. Для каждой записи требуется PalID и положительный Level.
Схема ответа
200 response schema
| Field | Type | Description |
|---|---|---|
Granted |
object | Counts granted by the request. |
Granted object schema:
| Field | Type | Description |
|---|---|---|
Pals |
integer | Number of Pals granted. |
Реакции на ошибки
Тела ошибок используют следующую форму:
| HTTP | Код ошибки | Когда это произойдет |
|---|---|---|
401 |
INVALID_TOKEN |
Заголовок Authorization отсутствует, имеет неправильный формат или не соответствует настроенному токену носителя. |
403 |
MISSING_PERMISSION |
Токен действителен, но не включает это разрешение конечной точки. |
400 |
INVALID_JSON |
Текст запроса был предоставлен, но его не удалось проанализировать как JSON. |
400 |
REQUEST_FAILED |
Обратный вызов игрового потока вызвал исключение, или произошел сбой общего преобразователя player/resource. |
500 |
REQUEST_TIMEOUT |
Обратный вызов внутреннего игрового потока не завершился в течение 5 секунд. |
400 |
INVALID_REQUEST |
Тело не содержит Pals array. |
400 |
VALIDATION_FAILED |
Один или несколько грантов Pal недействительны, или у игрока недостаточно места для хранения Pal. |
Примеры
Дайте стартовый Pal игроку GDK.
Дайте событию Pals по PlayerUID
Сценарии
- Предоставляйте простые награды Pal без сохранения файла шаблона.
- Используйте для сценариев случайных наград, которые различаются только
PalIDиLevel. - Запрос может завершиться неудачно, если игрок не может быть найден,
PalIDнедействителен или недостаточно места для хранения Pal.