POST /give/pals/{player_identifier}
エンドポイント: POST /v1/pdapi/give/pals/<player_identifier>
認証: ベアラートークン
許可: REST.Pals.Give
目的
ID とレベル別に 1 つ以上の Pals を指定します。
パスパラメータ
player_identifier: 対象プレイヤーのUserIdまたはPlayerUID。
クエリパラメータ
なし。
リクエストボディ
JSON object と Pals、Pal の array が付与されます。各エントリには 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 |
ゲーム スレッド コールバックが例外をスローしたか、共有プレーヤー/リソース リゾルバーが失敗しました。 |
500 |
REQUEST_TIMEOUT |
内部ゲーム スレッド コールバックは 5 秒以内に完了しませんでした。 |
400 |
INVALID_REQUEST |
本体には Pals array が含まれていません。 |
400 |
VALIDATION_FAILED |
1 つ以上の Pal 付与が無効であるか、プレーヤーに Pal ストレージ容量が不足しています。 |
例
GDK プレーヤーにスターター Pal を与える
PlayerUID でイベント Pals を与える
シナリオ
- テンプレート ファイルを維持せずに、単純な Pal 報酬を与えます。
PalIDとLevelのみが異なるランダムな報酬スクリプトに使用します。- プレーヤーが見つからない場合、
PalIDが無効である場合、または十分な Pal ストレージ容量がない場合、リクエストは失敗する可能性があります。