{"openapi":"3.0.1","info":{"title":"94hi Frontend API","description":"This API document was designed for the communication between 94hi frontend and it's renderer service server.","version":"v0.1"},"servers":[{"url":"https://localhost:8080/api/"},{"url":"http://localhost:8080/api/"}],"paths":{"/signup":{"post":{"tags":["Account"],"summary":"註冊帳號 -1","description":"註冊帳號流程分兩個步驟，第一步驟為輸入電話/密碼，第二步驟為簡訊驗証電話號碼。電話號碼驗証成功之後才算帳號建立完成。\n- 電話號碼驗証成功之前可使用相同電話號碼重覆進行註冊帳號動作\n- 電話號碼驗証成功之後才可使用 Login 登入帳號。","requestBody":{"description":"information for account registration","content":{"application/json":{"schema":{"required":["country","password","phoneNo"],"type":"object","properties":{"country":{"type":"string","description":"國碼","example":"886"},"phoneNo":{"type":"string","description":"手機號碼","example":"0912345678"},"password":{"type":"string","description":"密碼 (包碼數字字母最大8位)","example":"abcd1234"}}}}},"required":true},"responses":{"200":{"description":"Successful","content":{"application/json":{"schema":{"type":"object","properties":{"tmp_access_token":{"type":"string","description":"暫時的 access token。\n- 執行註冊帳號 -2 時使用 (apiKey)\n- Request SMS Verification Code 時使用 (apiKey)","example":"[TMP ACCESS TOKEN FOR REGISTRATION]"}}}}}},"400":{"description":"post data error","content":{}},"406":{"description":"phone number was occupied","content":{}}},"x-codegen-request-body-name":"data"},"put":{"tags":["Account"],"summary":"註冊帳號 -2","description":"輸入簡訊驗証碼後完成註冊及自動登入。","requestBody":{"description":"verification code sent via SMS","content":{"application/json":{"schema":{"required":["code"],"type":"object","properties":{"code":{"type":"string","description":"簡訊註冊驗証碼<br/>(呼叫 Request SMS Verification Code API, type: signup 取得)"}}}}},"required":true},"responses":{"200":{"description":"Successful","content":{"application/json":{"schema":{"type":"object","properties":{"access_token":{"type":"string","description":"Level1 Access Token","example":"[ACCESS TOKEN]"}}}}}},"400":{"description":"verification code error","content":{}},"401":{"description":"tmp access token error/expired","content":{}}},"security":[{"Token":[]}],"x-codegen-request-body-name":"data"}},"/login":{"post":{"tags":["Account"],"summary":"登入 Account -1","description":"登入後獲得 Level1 Access Token。\n- LV1 Access Token 只能存取 Account 資料。\n- 可同時存在多個有效 LV1 Access Token 存取 Account 資料。(不踢舊的登入)","requestBody":{"description":"information for account login (the remember parameter means the client wants the access token should be valid at least 30 days)","content":{"application/json":{"schema":{"required":["password","phoneNo","phonePrefix","remember","pk","recaptcha_token"],"type":"object","properties":{"phonePrefix":{"type":"string","description":"國碼","example":"886"},"phoneNo":{"type":"string","example":"0912345678"},"password":{"type":"string","example":"abcd1234"},"remember":{"type":"boolean","description":"保持登入 30 日"},"pk":{"type":"string","description":"recaptcha public key"},"recaptcha_token":{"type":"string","description":"recaptcha 提供之 token"}}}}},"required":true},"responses":{"200":{"description":"Successful","content":{"application/json":{"schema":{"type":"object","properties":{"access_token":{"type":"string","description":"Level1 Access Token","example":"[ACCESS TOKEN]"}}}}}},"202":{"description":"2FA Login required","content":{"application/json":{"schema":{"type":"object","properties":{"access_token_2fa":{"type":"string","description":"暫時的 Access Token，2FA 登入使用。","example":"[ACCESS TOKEN FOR 2FA]"}}}}}},"404":{"description":"phone number or password not found","content":{}}},"x-codegen-request-body-name":"data"},"put":{"tags":["Account"],"summary":"登入 Account -2 (2FA)","requestBody":{"content":{"application/json":{"schema":{"required":["access_token_2fa","code"],"type":"object","properties":{"code":{"type":"string","description":"2FA Code"},"access_token_2fa":{"type":"string"}}}}},"required":true},"responses":{"200":{"description":"Successful","content":{"application/json":{"schema":{"type":"object","properties":{"access_token":{"type":"string","description":"Level1 Access Token","example":"[ACCESS TOKEN]"}}}}}},"400":{"description":"verification code error","content":{}},"401":{"description":"access token error/expired","content":{}}},"security":[{"Token":[]}],"x-codegen-request-body-name":"data"}},"/pwd":{"patch":{"tags":["Account"],"summary":"更新密碼","requestBody":{"content":{"application/json":{"schema":{"required":["new","origin"],"type":"object","properties":{"origin":{"type":"string","description":"舊密碼"},"new":{"type":"string","description":"新密碼"}}}}},"required":true},"responses":{"200":{"description":"Successful","content":{}},"400":{"description":"origin password error","content":{}},"401":{"description":"access token error/expired","content":{}},"402":{"description":"cannot reuse an old password","content":{}}},"security":[{"Token":[]}],"x-codegen-request-body-name":"data"}},"/pwd/reset":{"get":{"tags":["Account"],"summary":"取得重設密碼簡訊","description":"要求取得重設密碼之 url 連結，連結將透過 SMS 傳送。","parameters":[{"name":"country","in":"query","description":"國碼","required":true,"schema":{"type":"string"}},{"name":"phoneNo","in":"query","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"Successful","content":{}},"404":{"description":"phone number not found","content":{}}}},"post":{"tags":["Account"],"summary":"重設密碼","description":"利用由簡訊獲得之 token，可在不登入狀態下直接設定新密碼。","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"token":{"type":"string"},"password":{"type":"string","description":"新密碼"}}}}},"required":true},"responses":{"200":{"description":"Successful","content":{}},"401":{"description":"access token error/expired","content":{}}},"x-codegen-request-body-name":"data"}},"/account/sms":{"get":{"tags":["Account"],"summary":"Request SMS Verification Code","description":"要求寄送手機簡訊驗証碼 (若是寄送之冷卻時間未倒數完成則跳過寄送，直接回覆剩餘冷卻時間。)","parameters":[{"name":"type","in":"query","description":"欲驗証的目標\n - signup:註冊驗証碼\n - account_verify:帳戶認証驗証碼 (雖然註冊時驗証過, 但90日後要重新驗證)\n - forget:取得密記密碼時之重設 URL\n - unbind:取得解綁認証驗証碼\n - order:訂單\n","required":true,"schema":{"type":"string","enum":["signup","account_verify","forget","unbind","order"]}}],"responses":{"200":{"description":"Successful","content":{"application/json":{"schema":{"type":"object","properties":{"countdown":{"type":"integer","description":"下次重寄倒數 (秒)","example":0}}}}}},"400":{"description":"驗証 type 錯誤","content":{}},"401":{"description":"access token error/expired","content":{}}},"security":[{"Token":[]}]}},"/account/verify":{"put":{"tags":["Account"],"summary":"驗證帳號","description":"驗證帳號。Note: 已驗證的帳號將再 90 日之後失效","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"驗證碼 (透過 API : Request SMS Verification Code 取得)"}}}}},"required":true},"responses":{"200":{"description":"Successful","content":{}},"400":{"description":"verification code error","content":{}},"401":{"description":"access token error/expired","content":{}}},"security":[{"Token":[]}],"x-codegen-request-body-name":"data"}},"/2fa":{"put":{"tags":["Account"],"summary":"2-Factor Authentication","description":"設定登入時使用 2FA 的狀態","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"Google Authenticator 產生的 6 位數驗證碼"},"status":{"type":"boolean","description":"啟用或關閉"}}}}},"required":true},"responses":{"200":{"description":"Successful","content":{}},"400":{"description":"code error","content":{}},"401":{"description":"access token error/expired","content":{}}},"security":[{"Token":[]}],"x-codegen-request-body-name":"code"}},"/account":{"get":{"tags":["Account"],"summary":"取得帳號資料","responses":{"200":{"description":"Successful","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AccountData"}}}},"401":{"description":"access token error/expired","content":{}}},"security":[{"Token":[]}]},"patch":{"tags":["Account"],"summary":"更新帳號資料","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"acc_nickname":{"type":"string"},"acc_phoneno":{"type":"string"},"acc_email":{"type":"string"}}}}},"required":true},"responses":{"200":{"description":"Successful","content":{}},"400":{"description":"patch data error","content":{}},"401":{"description":"access token error/expired","content":{}}},"security":[{"Token":[]}],"x-codegen-request-body-name":"data"}},"/account/achievement":{"get":{"tags":["Account"],"summary":"取得會員任務資料","responses":{"200":{"description":"Successful","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AchievementData"}}}},"401":{"description":"access token error/expired","content":{}}},"security":[{"Token":[]}]},"post":{"tags":["Account"],"summary":"領取/兌換會員任務獎勵","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"member_id":{"type":"string"},"achievement_id":{"type":"string"}}}}},"required":true},"responses":{"200":{"description":"Successful","content":{}},"401":{"description":"access token error/expired","content":{}},"404":{"description":"id not found","content":{}},"405":{"description":"achievement not completed","content":{}}},"security":[{"Token":[]}],"x-codegen-request-body-name":"data"}},"/account/daily_checkout":{"post":{"tags":["Account"],"summary":"領取每日簽到獎勵 (當天)","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"member_id":{"type":"string"}}}}},"required":true},"responses":{"200":{"description":"Successful","content":{}},"401":{"description":"access token error/expired","content":{}},"405":{"description":"reward not available","content":{}}},"security":[{"Token":[]}],"x-codegen-request-body-name":"data"}},"/member/login":{"post":{"tags":["Member"],"summary":"登入/切換 Member","description":"登入/切換後獲得 Level 2 Access Token\n- 此 level 2 access token 能存取 Account 及 Member 資料。\n-登入後，原 lv1/lv2 access token 作廢。\n- \"不\"可同時存在多個有效 lv2 access token。(踢掉舊的 lv2 登入)","requestBody":{"content":{"application/json":{"schema":{"required":["member_id"],"type":"object","properties":{"member_id":{"type":"string"}}}}},"required":true},"responses":{"200":{"description":"Successful","content":{"application/json":{"schema":{"type":"object","properties":{"access_token":{"type":"string","description":"Level2 Access Token"}}}}}},"400":{"description":"posted data error","content":{}},"401":{"description":"access token error/expired","content":{}}},"security":[{"Token":[]}],"x-codegen-request-body-name":"data"}},"/member":{"get":{"tags":["Member"],"summary":"取得會員資料","description":"回傳指定會員ID (Member ID) 所對映的資料 (必須是自己的會員 ID，或者是非綁定中的會員 ID)","parameters":[{"name":"id","in":"query","description":"MemberID","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MemberData"}}}},"401":{"description":"access token error/expired","content":{}},"404":{"description":"member data not found","content":{}}},"security":[{"Token":[]}]}},"/member/mid/recommend":{"get":{"tags":["Member"],"summary":"取得預設 Member ID","description":"建立新的 Member ID 時先向後端取得並顯示預設的 (建議的) Member ID","responses":{"200":{"description":"Successful","content":{"application/json":{"schema":{"type":"object","properties":{"prefix":{"type":"string","example":"ABCD"},"postfix":{"type":"string","example":"1234"}}}}}},"401":{"description":"access token error/expired","content":{}}},"security":[{"Token":[]}]}},"/member/mid/create":{"post":{"tags":["Member"],"summary":"建立新的 Member ID","requestBody":{"content":{"application/json":{"schema":{"required":["postfix","prefix"],"type":"object","properties":{"prefix":{"type":"string","example":"ABCD"},"postfix":{"type":"string","example":"1234"}}}}},"required":true},"responses":{"200":{"description":"Successful","content":{}},"401":{"description":"access token error/expired","content":{}},"405":{"description":"not enough member seats","content":{}},"406":{"description":"member id was occupied","content":{}}},"security":[{"Token":[]}],"x-codegen-request-body-name":"data"}},"/member/mid/bind":{"post":{"tags":["Member"],"summary":"綁定 Member ID","requestBody":{"content":{"application/json":{"schema":{"required":["secret_code"],"type":"object","properties":{"secret_code":{"type":"string","description":"會員ID綁定碼","example":"ABCD1234RNDVAL"}}}}},"required":true},"responses":{"200":{"description":"Successful","content":{"application/json":{"schema":{"type":"object","properties":{"mid":{"type":"string","description":"已綁定之 Member ID"}}}}}},"401":{"description":"access token error/expired","content":{}},"404":{"description":"secret code not found","content":{}},"405":{"description":"not enough member seats","content":{}}},"security":[{"Token":[]}],"x-codegen-request-body-name":"data"}},"/member/mid/unbind":{"get":{"tags":["Member"],"summary":"MemberID 解除綁定 -1","description":"要求解除綁定 Member ID 並且寄送 SMS 驗証簡訊。","parameters":[{"name":"id","in":"query","description":"Member ID","required":true,"schema":{"type":"string"}}],"responses":{"202":{"description":"SMS Verification Required","content":{}},"401":{"description":"access token error/expired","content":{}},"404":{"description":"member id not found","content":{}}},"security":[{"Token":[]}]},"put":{"tags":["Member"],"summary":"MemberID 解除綁定 -2","requestBody":{"content":{"*/*":{"schema":{"required":["code","id"],"type":"object","properties":{"id":{"type":"string","description":"Member ID"},"code":{"type":"string","description":"SMS 驗証碼 (透過 Member ID 解除綁定 -1 取得)"}}}}},"required":true},"responses":{"200":{"description":"Successful","content":{}},"401":{"description":"access token error/expired","content":{}},"404":{"description":"member id not found","content":{}},"405":{"description":"code error","content":{}}},"security":[{"Token":[]}],"x-codegen-request-body-name":"data"}},"/member/mid/unbind/cancel":{"patch":{"tags":["Member"],"summary":"MemberID 取消解除綁定","requestBody":{"content":{"application/json":{"schema":{"required":["id"],"type":"object","properties":{"id":{"type":"string","description":"Member ID"}}}}},"required":true},"responses":{"200":{"description":"Successful","content":{}},"401":{"description":"access token error/expired","content":{}},"404":{"description":"member id not found","content":{}}},"security":[{"Token":[]}],"x-codegen-request-body-name":"data"}},"/member/investment":{"get":{"tags":["Member"],"summary":"取得投資資料","parameters":[{"name":"member_id","in":"query","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InvestmentData"}}}},"401":{"description":"access token error/expired","content":{}},"404":{"description":"member id not found","content":{}}},"security":[{"Token":[]}]},"patch":{"tags":["Member"],"summary":"領取投資","requestBody":{"content":{"application/json":{"schema":{"required":["investment_type","item","mid"],"type":"object","properties":{"mid":{"type":"string","description":"Member ID"},"investment_type":{"type":"string","enum":["monthly","season"]},"item":{"type":"string","description":"欲領取的項目 ID (principal, day_1~day_n)"}}}}},"required":true},"responses":{"200":{"description":"Successful","content":{}},"401":{"description":"access token error/expired","content":{}},"404":{"description":"member id not found","content":{}},"405":{"description":"access forbidden","content":{}}},"security":[{"Token":[]}],"x-codegen-request-body-name":"data"}},"/order":{"get":{"tags":["Order"],"summary":"取得訂單資訊","parameters":[{"name":"order_id","in":"query","description":"訂單 ID (建立訂單之後產生)","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrderData"}}}},"401":{"description":"access token error/expired","content":{}},"404":{"description":"order data not found","content":{}}},"security":[{"Token":[]}]},"post":{"tags":["Order"],"summary":"建立訂單","description":"建立訂單如下:\n- 兌換遊戲點數 (redeem)\n- 帳號點數轉點 (transfer)\n- 序號兌換 (exchange)\n- 儲值到平台 (depositToPlatform)\n- 儲值到遊戲 (depositToGame)\n- 預購遊戲 (pledge)\n- 購買會員ID欄位 (memberSeat)\n- 購買月卡/季卡 (investment)<br/>ps. 部分訂單使用 ATM 匯款方式將回覆 202，則須持續進行驗証訂單動作後完成訂單建立。","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrderData"}}},"required":true},"responses":{"200":{"description":"Successful","content":{"application/json":{"schema":{"type":"object","properties":{"orderid":{"type":"string"}}}}}},"202":{"description":"SMS Verification Required","content":{"application/json":{"schema":{"type":"object","properties":{"orderid":{"type":"string"}}}}}},"400":{"description":"post data error","content":{}},"401":{"description":"access token error/expired","content":{}},"403":{"description":"購買失敗並顯示詳細訊息","content":{"application/json":{"schema":{"type":"object","properties":{"msg":{"type":"string"}}}}}},"404":{"description":"member id not found","content":{}}},"security":[{"Token":[]}],"x-codegen-request-body-name":"data"}},"/order/verify":{"put":{"tags":["Order"],"summary":"驗証訂單","description":"驗証訂單如下:\n- 購買會員ID欄位 (使用 ATM 方式購買)\n- 購買會員投資 (使用 ATM 方式購買)\n- 遊戲預購 (使用 ATM 方式購買)\n- 儲值到平台 (ATM 付款方式)\n- 儲值到遊戲(ATM 付款方式)\n- 帳號點數轉點","requestBody":{"content":{"application/json":{"schema":{"required":["orderid","verification_code"],"type":"object","properties":{"orderid":{"type":"string","description":"訂單編號"},"verification_code":{"type":"string","description":"驗証碼 (透過 API: Request SMS Verification Code For The Order 取得)"}}}}},"required":true},"responses":{"200":{"description":"Successful","content":{"application/json":{"schema":{"type":"object","properties":{"orderid":{"type":"string"}}}}}},"401":{"description":"access token error/expired","content":{}},"403":{"description":"驗証失敗並顯示詳細訊息","content":{"application/json":{"schema":{"type":"object","properties":{"msg":{"type":"string"}}}}}},"404":{"description":"order id not found","content":{}},"405":{"description":"verification code error","content":{}}},"security":[{"Token":[]}],"x-codegen-request-body-name":"data"}},"/order/history":{"get":{"tags":["Order"],"summary":"查詢訂單歷史記錄","parameters":[{"name":"member_id","in":"query","required":true,"schema":{"type":"string"}},{"name":"duration","description":"最近天數","in":"query","required":true,"schema":{"type":"integer","enum":[7,30,60,90]}}],"responses":{"200":{"description":"Successful","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/OrderData"}}}}},"401":{"description":"access token error/expired","content":{}},"404":{"description":"member id not found","content":{}}},"security":[{"Token":[]}]}},"/order/payment_method":{"get":{"tags":["Order"],"summary":"取得可使用之購買方式","responses":{"200":{"description":"Successful","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/OrderData"}}}}},"401":{"description":"access token error/expired","content":{}},"404":{"description":"member id not found","content":{}}},"security":[{"Token":[]}]}},"/order/products":{"get":{"tags":["Order"],"summary":"取得可購買之 Product 列表","parameters":[{"name":"member_id","in":"query","required":true,"schema":{"type":"string"}},{"name":"duration","description":"最近天數","in":"query","required":true,"schema":{"type":"integer","enum":[7,30,60,90]}}],"responses":{"200":{"description":"Successful","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/OrderData"}}}}},"401":{"description":"access token error/expired","content":{}},"404":{"description":"member id not found","content":{}}},"security":[{"Token":[]}]}},"/home":{"get":{"tags":["Home"],"summary":"取得首頁資料","responses":{"200":{"description":"Successful","content":{"application/json":{"schema":{"type":"object","properties":{"carousel_list":{"type":"array","items":{"type":"object","properties":{"img_url":{"type":"string"},"route_name":{"type":"string"},"route_params":{"type":"object","properties":{}},"route_query":{"type":"object","properties":{}}}}},"game_list":{"type":"array","items":{"type":"object","properties":{"cover_img_url":{"type":"string"},"name":{"type":"string"},"type":{"type":"string","enum":["PC","WEB","H5","APP"]},"desc":{"type":"string"},"gameid":{"type":"string"}}}},"news":{"type":"array","items":{"type":"object","properties":{"newsid":{"type":"string","description":"焦點資訊 UID"},"cover_img_url":{"type":"string"},"title":{"type":"string"},"brief":{"type":"string"},"newscat":{"type":"string","enum":["platform","PC","WEB","H5","APP"]},"newstype":{"type":"string","enum":["all","platform","game"]},"date":{"type":"string","format":"date"}}}},"pledge_list":{"type":"array","items":{"$ref":"#/components/schemas/PreorderData"}}}}}}}}}},"/home/news":{"get":{"tags":["Home"],"summary":"取得焦點資訊列表","parameters":[{"name":"news_type","in":"query","required":true,"schema":{"type":"string","enum":["all","platform","game"]}},{"name":"page","in":"query","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"Successful","content":{"application/json":{"schema":{"type":"object","properties":{"count":{"type":"integer","description":"總筆數"},"newstype":{"type":"string","enum":["all","platform","game"]},"page":{"type":"integer","description":"目前頁數"},"list":{"type":"array","description":"該頁資料列表","items":{"type":"object","properties":{"id":{"type":"string","description":"焦點資訊 UID"},"newscat":{"type":"string","enum":["platform","PC","WEB","H5","APP"]},"newstype":{"type":"string","enum":["all","platform","game"]},"title":{"type":"string"},"brief":{"type":"string"},"date":{"type":"string","format":"date"}}}}}}}}}}}},"/home/news/detail":{"get":{"tags":["Home"],"summary":"取得焦點資訊資料","parameters":[{"name":"news_id","in":"query","description":"焦點資訊 UID","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"Successful","content":{"application/json":{"schema":{"type":"object","properties":{"newsid":{"type":"string","description":"焦點資訊 UID"},"name":{"type":"string"},"cover_img_url":{"type":"string"},"newstype":{"type":"string","enum":["all","platform","game"]},"title":{"type":"string"},"context":{"type":"string"},"date":{"type":"string","format":"date"}}}}}},"404":{"description":"news id not found","content":{}}}}},"/preorder":{"get":{"tags":["Preorder"],"summary":"取得預購遊戲列表","parameters":[{"name":"sort_type","in":"query","schema":{"type":"string","enum":["date","time_remaining","completed","end"]}},{"name":"search_keyword","in":"query","schema":{"type":"string"}},{"name":"page","in":"query","schema":{"type":"integer"}}],"responses":{"200":{"description":"Successful","content":{"application/json":{"schema":{"type":"object","properties":{"count":{"type":"integer","description":"總筆數"},"page":{"type":"integer","description":"目前頁數"},"list":{"type":"array","items":{"$ref":"#/components/schemas/PreorderData"}}}}}}}}}},"/preorder/detail":{"get":{"tags":["Preorder"],"summary":"取得預購遊戲資料","parameters":[{"name":"orderid","in":"query","description":"預購遊戲 ID","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PreorderData"}}}},"404":{"description":"preorder data not found","content":{}}}}},"/preorder/msg":{"get":{"tags":["Preorder"],"summary":"取得預購遊戲留言資料","parameters":[{"name":"orderid","in":"query","description":"預購遊戲 ID","schema":{"type":"string"}},{"name":"page","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful","content":{"application/json":{"schema":{"type":"object","properties":{"count":{"type":"integer","description":"總筆數"},"page":{"type":"integer","description":"目前頁數"},"list":{"type":"array","items":{"type":"object","properties":{"mid":{"type":"string"},"msg":{"type":"string"},"date":{"type":"string","format":"date"}}}}}}}}},"404":{"description":"preorder data not found","content":{}}}}},"/preorder/pledges":{"get":{"tags":["Preorder"],"summary":"取得預購遊戲內各別預購項目","parameters":[{"name":"orderid","in":"query","description":"預購遊戲 ID","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"price":{"type":"integer"},"name":{"type":"string"},"content":{"type":"array","items":{"type":"string"}},"backers":{"type":"integer"},"pledge_type":{"type":"string","enum":["normal","limit_time","limit_quantity"]},"limit_time":{"type":"string"},"limit_quantity":{"type":"integer"}}}}}}},"404":{"description":"preordering game id not found","content":{}}}}},"/game":{"get":{"tags":["Game"],"summary":"取得遊戲列表","parameters":[{"name":"type","in":"query","required":true,"schema":{"type":"string","enum":["all","h5","app","pc","web"]}}],"responses":{"200":{"description":"Successful","content":{"application/json":{"schema":{"type":"object","properties":{"recently":{"type":"array","description":"最近玩家的遊戲","items":{"$ref":"#/components/schemas/GameData"}},"recommend":{"type":"array","description":"猜您喜歡的遊戲","items":{"$ref":"#/components/schemas/GameData"}},"gamelist":{"type":"array","description":"全部遊戲","items":{"$ref":"#/components/schemas/GameData"}}}}}}}}}},"/game/news":{"get":{"tags":["Game"],"summary":"取得最新消息列表","parameters":[{"name":"game_id","in":"query","required":true,"schema":{"type":"string"}},{"name":"page","in":"query","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"Successful","content":{"application/json":{"schema":{"type":"object","properties":{"count":{"type":"integer","description":"總筆數"},"gameid":{"type":"string"},"gametype":{"type":"string","enum":["h5","app","web","pc"]},"name":{"type":"string"},"page":{"type":"integer","description":"目前頁數"},"cover_img_url":{"type":"string"},"list":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"newstype":{"type":"string","enum":["all","platform","game"]},"title":{"type":"string"},"brief":{"type":"string"},"date":{"type":"string","format":"date"}}}}}}}}},"404":{"description":"game id not found","content":{}}}}},"/game/news/detail":{"get":{"tags":["Game"],"summary":"取得最新消息","parameters":[{"name":"game_id","in":"query","required":true,"schema":{"type":"string"}},{"name":"news_id","in":"query","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"Successful","content":{"application/json":{"schema":{"type":"object","properties":{"gameid":{"type":"string"},"name":{"type":"string"},"cover_img_url":{"type":"string"},"newsid":{"type":"string"},"newstype":{"type":"string","enum":["all","platform","game"]},"title":{"type":"string"},"context":{"type":"string"},"date":{"type":"string","format":"date"}}}}}},"404":{"description":"game id /news id not found","content":{}}}}},"/game/summary":{"get":{"tags":["Game"],"summary":"取得遊簡介","parameters":[{"name":"game_id","in":"query","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GameSummary"}}}},"404":{"description":"game id not found","content":{}}}}},"/game/moving":{"patch":{"tags":["Game"],"summary":"設定遊戲所屬 MemberID","requestBody":{"content":{"application/json":{"schema":{"required":["data_id","dst_member_id","src_member_id"],"type":"object","properties":{"src_member_id":{"type":"string"},"dst_member_id":{"type":"string"},"data_id":{"type":"string"}}}}},"required":true},"responses":{"200":{"description":"Successful","content":{}},"401":{"description":"access token error/expired","content":{}},"405":{"description":"data error","content":{}}},"security":[{"Token":[]}],"x-codegen-request-body-name":"data"}},"/transfer/game":{"get":{"tags":["Game"],"summary":"取得其它遊戲綁定之遊戲列表","parameters":[{"name":"user_id","in":"query","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"game_id":{"type":"string"},"game_name":{"type":"string"},"game_logo_url":{"type":"string"},"game_pic_url":{"type":"string"}}}}}}},"404":{"description":"user_id not found","content":{}}}}},"/transfer/game/detail":{"get":{"tags":["Game"],"summary":"取得其它遊戲綁定之遊戲資料","parameters":[{"name":"user_id","in":"query","required":true,"schema":{"type":"string"}},{"name":"game_id","in":"query","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"game_id":{"type":"string"},"user_id":{"type":"string"},"role_id":{"type":"string"},"server_name":{"type":"string"},"role_name":{"type":"string"}}}}}}},"404":{"description":"game id not found","content":{}},"405":{"description":"user_id not found","content":{}}}}},"/transfer":{"post":{"tags":["Game"],"summary":"完成其它遊戲綁定","requestBody":{"content":{"application/json":{"schema":{"required":["game_id","member_id","user_id"],"type":"object","properties":{"user_id":{"type":"string"},"game_id":{"type":"string"},"member_id":{"type":"string"}}}}},"required":true},"responses":{"200":{"description":"Successful","content":{}},"401":{"description":"access token error/expired","content":{}},"405":{"description":"data error","content":{}},"406":{"description":"game data has already exsists","content":{}}},"security":[{"Token":[]}],"x-codegen-request-body-name":"data"}}},"components":{"schemas":{"GameSummary":{"type":"object","properties":{"gameid":{"type":"string"},"name":{"type":"string"},"gametype":{"type":"string","enum":["h5","app","web","pc"]},"download_url":{"type":"object","properties":{"pc":{"type":"string"},"ios":{"type":"string"},"android":{"type":"string"},"apk":{"type":"string"}}},"cover_img_url":{"type":"string"},"icon_img_url":{"type":"string"},"introduce":{"type":"object","properties":{"title":{"type":"string"},"context":{"type":"string"},"maintenance":{"type":"string"}}},"news":{"type":"array","items":{"type":"object","properties":{"news_type":{"type":"string"},"news_title":{"type":"string"},"news_id":{"type":"string"},"news_date":{"type":"string","format":"date"}}}},"fb_info":{"type":"object","properties":{"fb_id":{"type":"string"},"fb_url":{"type":"string"}}},"yt_info":{"type":"object","properties":{"yt_url":{"type":"string"}}},"ext_image_url":{"type":"array","items":{"type":"string"}}}},"GameData":{"type":"object","properties":{"gameid":{"type":"string"},"name":{"type":"string"},"liveplayers":{"type":"integer"},"gametype":{"type":"string","enum":["h5","app","web","pc"]},"imageurl":{"type":"string"}}},"MemberData":{"type":"object","properties":{"status":{"type":"string","enum":["normal","disabled","unbound"]},"secret_bind_id":{"type":"string","description":"會員ID綁定碼 (若此會員ID處於未綁定狀態則可利用 API : 綁定 Member ID 進行綁定)"},"mid":{"type":"string"},"pts":{"type":"integer"},"bonus_pts":{"type":"array","items":{"type":"object","properties":{"duration":{"type":"string","description":"年月 ex:YYYY-MM"},"quantity":{"type":"integer","description":"累積張數"}}}},"gamedata":{"type":"array","items":{"type":"object","properties":{"data_uid":{"type":"string"},"game_id":{"type":"string"},"game_name":{"type":"string"},"game_logo_url":{"type":"string"},"game_pic_url":{"type":"string"},"server_name":{"type":"string"},"role_name":{"type":"string"},"role_id":{"type":"string"}}}}}},"AccountData":{"type":"object","properties":{"acc_id":{"type":"object","properties":{"prefix":{"type":"integer"},"phone":{"type":"integer"}},"description":"帳號名稱 (手機國碼+電話號碼)"},"acc_nickname":{"type":"string"},"acc_uid":{"type":"string","description":"帳號唯一識別碼 (UID)"},"acc_verified":{"type":"boolean","description":"是否已驗証"},"acc_security":{"type":"boolean","description":"2FA 是否啟用"},"acc_email":{"type":"string"},"acc_phoneno":{"type":"string"},"acc_coupon_count":{"type":"integer"},"acc_mids":{"type":"array","description":"此帳號之 MemberID 列表","items":{"type":"string"}},"acc_available_mid_seats":{"type":"integer","description":"最大可建立之 MemberID 數量，預設為 2。","example":2},"totp_uri":{"type":"string","description":"Google Authenticator QRCODE","example":"otpauth://totp/94hi:8860913888258%4094hi?secret=3X73NSUGHT77KRXY&issuer=94hi"}}},"AchievementData":{"type":"object","properties":{"count_days":{"type":"integer","description":"目前計算的天數 (註冊日開始由 1 起算)"},"redeemed_date":{"type":"array","description":"有簽到的天數 ex: 註冊後前三天都有簽到 : [1, 2, 3 ]","items":{"type":"integer"}},"achievement_status":{"type":"array","description":"列出所有優專券/成就/任務資料","items":{"type":"object","properties":{"title":{"type":"string","description":"顯示名稱"},"subtitle":{"type":"string","description":"任務說明"},"progress":{"type":"integer","description":"任務目前達成進度 (百分比)"},"achievement_id":{"type":"string","description":"ID (領取時使用)"},"type":{"type":"string","description":"屬性 :\n- coupon (優惠券)\n- mission (成就獎勵)","enum":["daily","coupon","mission"]},"bonus_val":{"type":"integer"},"status":{"type":"string","description":"狀態 :\n- available 可領取\n- unavailable 不可領取\n- redeemed 已領取","enum":["available","unavailable","redeemed"]}}}}}},"InvestmentData":{"type":"object","properties":{"monthly":{"type":"object","properties":{"investment_type":{"type":"string","enum":["monthly","season"]},"mid":{"type":"string","description":"Member ID"},"enabled":{"type":"boolean","description":"投資是否可用"},"start_date":{"type":"string","description":"開始日期 (開始當天可領取 principal)","format":"date"},"redeemed":{"type":"array","description":"已領取的 ID (principal, day_1 ~ day_n)","items":{"type":"string"}}},"description":"會員月卡"},"season":{"type":"object","properties":{"investment_type":{"type":"string","enum":["monthly","season"]},"mid":{"type":"string","description":"Member ID"},"enabled":{"type":"boolean","description":"投資是否可用"},"start_date":{"type":"string","description":"開始日期 (開始當天可領取 principal)","format":"date"},"redeemed":{"type":"array","description":"已領取的 ID (principal, day_1 ~ day_n)","items":{"type":"string"}}},"description":"會員季卡"}}},"PreorderData":{"type":"object","properties":{"id":{"type":"string","description":"預購遊戲 ID"},"cover_img_url":{"type":"string"},"name":{"type":"string"},"developer":{"type":"string"},"introduce":{"type":"string"},"start_date":{"type":"string","format":"date"},"due_date":{"type":"string","format":"date"},"progress":{"type":"integer"},"accumulated":{"type":"integer"},"backers":{"type":"integer"},"status":{"type":"string","enum":["goal_not_met","goal_met","in_progress","uninitiated"]}}},"OrderData_transfer":{"type":"object","properties":{"deposit_type":{"type":"string","description":"訂單種類","enum":["pledge","depositToPlatform","depositToGame","exchange","transfer","redeem","memberSeat","investment"]},"member_id":{"type":"string"},"mid_to":{"type":"string"},"transfer_point":{"type":"integer"}}},"OrderData_redeem":{"type":"object","properties":{"deposit_type":{"type":"string","description":"訂單種類","enum":["pledge","depositToPlatform","depositToGame","exchange","transfer","redeem","memberSeat","investment"]},"member_id":{"type":"string"},"transfer_point":{"type":"integer"},"game_id":{"type":"string"},"role_id":{"type":"string"},"point_type":{"description":"點數種類:\n- value: 平台點數\n- free: 紅利點數","type":"string","enum":["value","free"]}}},"OrderData_depositToPlatform":{"type":"object","properties":{"deposit_type":{"type":"string","description":"訂單種類","enum":["pledge","depositToPlatform","depositToGame","exchange","transfer","redeem","memberSeat","investment"]},"member_id":{"type":"string"},"product_code":{"type":"string","description":"另外由 api 取得 product code list"},"payment_method":{"description":"付費方法:\n- web_atm\n- atm\n- creditcard\n- mycard\n- paypal\n- asiapay","type":"string","enum":["web_atm","atm","creditcard","mycard","paypal","asiapay"]}}},"OrderData_depositToGame":{"type":"object","properties":{"deposit_type":{"type":"string","description":"訂單種類","enum":["pledge","depositToPlatform","depositToGame","exchange","transfer","redeem","memberSeat","investment"]},"member_id":{"type":"string"},"product_code":{"type":"string","description":"另外由 api 取得 product code list"},"payment_method":{"description":"付費方法:\n- web_atm\n- atm\n- creditcard\n- mycard\n- paypal\n- asiapay","type":"string","enum":["web_atm","atm","creditcard","mycard","paypal","asiapay"]},"game_id":{"type":"string"},"role_id":{"type":"string"}}},"OrderData":{"type":"object","properties":{"order_id":{"type":"string"},"member_id":{"type":"string"},"deposit_type":{"type":"string","description":"訂單種類","enum":["pledge","depositToPlatform","depositToGame","exchange","transfer","redeem","memberSeat","investment"]},"payment_method":{"type":"string"},"payment_val":{"type":"integer"},"payment_vat":{"type":"integer"},"product_id":{"type":"string"},"product_name":{"type":"string"},"product_platform_pts":{"type":"integer"},"product_bonus_pts":{"type":"integer"},"receipt_type":{"type":"string"},"receipt_title":{"type":"string"},"receipt_no":{"type":"string"},"phoneno":{"type":"string"},"mail":{"type":"string"},"status":{"type":"string","enum":["sms verified","fail","success"]},"message":{"type":"string"},"date":{"type":"string","format":"date"},"server_id":{"type":"string"},"game_id":{"type":"string"},"role_id":{"type":"string"}}}},"securitySchemes":{"Token":{"type":"apiKey","name":"Authorization","in":"header"}}}}