プレゼント受け取りAPI Doc | SEMGAME-SERVER-SERVICE

API：プレゼント受け取り

プレゼント受け取り用APIです。
プレゼントBOXの受取ボタン、一括受取ボタンから本APIを呼び出してください。

基本情報

API PATH	/etc/getpresents
アクセストークンチェック	〇
メンテナンスチェック	〇
バージョンチェック	〇
バリデーションチェック	〇
同一リクエストチェック	〇
同一リクエスト時同一レスポンスを返却するか	×

リクエスト

No.	en	jp	型	制約	備考
1.	presentIds	プレゼントID一覧	List[Integer]	必須 List長:1～100 最小値:0 最大値:999999999

{
    "presentIds" : [
        0, 0
    ]
}

レスポンス

No.	en	jp	型	制約	備考
1.	presentsResult	プレゼント取得結果情報	List[DtoPresentResult]		個別受け取りの場合、指定したプレゼントの結果1件一括受け取りの場合、一括で受けとろうとしたプレゼント件数分
2.	itemInfo	取得アイテム結果情報	DtoPresentItemInfo

{
    "presentsResult" : [
        {
            "presentId" : 0,
            "unreceivedType" : 0,
            "receivedDate" : 0
        }
    ],
    "itemInfo" : {
        "items" : [
            {
                "itemId" : 0,
                "itemCount" : 0
            }
        ],
        "money" : 0,
        "givenStone" : 0,
        "presents" : [
            {
                "itemId" : 0,
                "itemCount" : 0,
                "presentId" : 0,
                "limitDate" : 0,
                "textsId" : "String"
            }
        ]
    }
}

エラー

API固有のエラーコードはありません。

Class/Dto/Model

・DtoPresentResult

No.	en	jp	型	備考
1.	presentId	プレゼントID	int	ユーザプレゼントテーブルのorder_id（連番）
2.	unreceivedType	受取成否タイプ	int	0:成功 1:受取済み 2:期限切れ 3:所持上限
3.	receivedDate	受取日時	long	受取失敗時は0（unixtime）

・DtoResponseItem

No.	en	jp	型	制約	備考
1.	itemId	アイテムID	int
2.	itemCount	数量	int

・DtoItemResultPresent

No.	en	jp	型	備考
1.	itemId	アイテムID	int
2.	itemCount	追加数量	int
3.	presentId	プレゼントID	int
4.	limitDate	受取期限	long	期限なしは0
5.	textsId	プレゼントテキストID	String

・DtoPresentItemInfo

No.	en	jp	型
1.	items	獲得処理したアイテム情報	List[DtoResponseItem]
2.	money	獲得処理したゲーム内マネー（合計）	int
3.	givenStone	獲得処理した仮想通貨（合計）	int
4.	presents	新規にプレゼントに入れたアイテム情報	List[DtoItemResultPresent]

参考マスタ

API固有のマスタはありません。

SEMGAME Doc -SEM GAME SERVER SERVICE-

API：プレゼント受け取り

基本情報

リクエスト

レスポンス

エラー

Class/Dto/Model

・DtoPresentResult

・DtoResponseItem

・DtoItemResultPresent

・DtoPresentItemInfo

参考マスタ

更新情報

運営会社