驗證方式 - HackMD

# 驗證方式 ```plaintext 連線方式均為 post ``` 加密方式 Sign 每次呼叫都必須在網址加上一個sign參數，而sign參數是以傳遞資料及API KEY產生: 先將參數陣列照key值進行升序排序 => 組成query string => 後面串上api key後md5加密 sign： ``` var params = { agent: agent, email: email, password: password }; var queryString=objectToQueryString(params); var sign = CryptoJS.MD5(queryString+ api_key ).toString() ``` ## 登入 ```plaintext Request POST /pawn/login ``` | 參數 | 型態 | 備註 | |----|----|----| | agent | str | 必要代理帳號 | | email | str | 必要會員信箱 | | password | str | 必要會員密碼 | | sign | str | 必要加密後鑰匙 | ```plaintext Response ``` | code | 說明 | 備註 | |------|----|----| | 1 | 成功 | | | Data | 說明 | 備註 | |------|----|----| | Api_key | 登入後 token | Bearer Token | ## 登出 ```plaintext Request POST /pawn/logout ``` | header | 型態 | 備註 | |------|----|----| | Bearer | str | 必要請由登入取得 Api_key (Bearer Token) | | 參數 | 型態 | 備註 | |----|----|----| | agent | str | 必要代理帳號 | | email | str | 必要會員信箱 | | sign | str | 必要加密後鑰匙 | ```plaintext Response ``` | code | 說明 | 備註 | |------|----|----| | 1 | 成功 | | ## 查詢會員 ```plaintext Request POST /pawn/show ``` | header | 型態 | 備註 | |------|----|----| | Bearer | str | 必要請由登入取得 Api_key (Bearer Token) | | 參數 | 型態 | 備註 | |----|----|----| | agent | str | 必要代理帳號 | | email | str | 必要會員信箱 | | sign | str | 必要加密後鑰匙 | ```plaintext Response ``` | code | 說明 | 備註 | |------|----|----| | 1 | 成功 | | | Data | 說明 | 備註 | |------|----|----| | User_id | 會員編號 | 唯一 (轉帳需要) | | Nickname | 暱稱 | | | E_mail | 電子信箱 | 會員ＰＫ值 | | E_mail_Auth | 是否驗證信箱 | ok 有，not 未驗證 | | Phone | 手機 | 會員ＰＫ值 | | Phone_auth | 是否驗證手機 | ok 有，not 未驗證 | | Level | 打碼等級 | | | Vip | 會員等級 | | | Bet_value_count | 有效投注總額 | | | Game_account | 會員遊戲帳號 | | | Game_amount | PE 點數 | | | Rebate_amount | PT 點數|| | In_game_amount | 遊戲內的點數|| | Game_free_amount | 免費遊戲內的點數|| | Eos_account | 有綁定的 eos 帳號 | | | Option | 其他 | 各平台客製化資訊 | | Referral_code| 玩家推薦馬| | | Is_First_Pay| 是否有內購過| | | Create_time|建立時間|| | Can_pay|是否開放充值| true 開放 <br> false 不開放| | V_wallet_list|綁定錢包列表| | | Create_time|註冊時間| | ## 轉PE ```plaintext Request POST /pawn/pe-credit-transaction ``` | header | 型態 | 備註 | |------|----|----| | Bearer | str | 必要請由登入取得 Api_key (Bearer Token) | | 參數 | 型態 | 備註 | |----|----|----| | user_code | str | 必要收款會員編碼 (User_id) | | amount | decimal(14,4) | 必要異動額度 | | password | str | 必要會員密碼 | | sign | str | 必要加密後鑰匙 | ```plaintext Response ``` | code | 說明 | 備註 | |------|----|----| | 1 | 成功 | | ## 更新會員資料 ```plaintext Request POST /pawn/update-member ``` | 參數 | 型態 | 備註 | |----|----|----| | new_phone | str(31) | 如果有要更新填入但已經有值不會修改（給用信箱註冊用的會員後續綁定電話用） | | new_email | str(255) | 如果有要更新填入但已經有值不會修改（給用電話註冊用的會員後續綁定信箱用） | | new_uuid | str(60) | 綁定新裝置ＩＤ選填 | | new_fb_id | str | 綁定新 fb_id 選填 | | new_google_id | str | 綁定 google_id 選填 | | new_apple_id | str | 綁定 apple_id 選填 | | new_password | str(63) | 修改新密碼選填 | | nick_name | str(99) | 選填 A-Za-z0-9 | ```plaintext Response ``` | code | 說明 | 備註 | |------|----|----| | 1 | 成功 | | ## 總公會長建立工會 ```plaintext Request POST /pawn/guild/master-create ``` | header | 型態 | 備註 | |------|----|----| | Bearer | str | 必要請由登入取得 Api_key (Bearer Token) | | 參數 | 型態 | 備註 | |----|----|----| | guild_introduce | str | 公會介紹選填 | | guild_name | str | 必要公會名稱 | | sign | str | 必要加密後鑰匙 | ```plaintext Response ``` | code | 說明 | 備註 | |------|----|----| | 1 | 成功 | | ## 總公會長任命公會長職位 ```plaintext Request POST /pawn/guild/assign-chairman ``` | header | 型態 | 備註 | |------|----|----| | Bearer | str | 必要請由登入取得 Api_key (Bearer Token) | | 參數 | 型態 | 備註 | |----|----|----| | new_chairman_id | int | 必要要任命公會長的會員 id | | guild_id | int | 必要要任命的公會 id | | sign | str | 必要加密後鑰匙 | ```plaintext Response ``` | code | 說明 | 備註 | |------|----|----| | 1 | 成功 | | ## 總公會長解除公會長職位 ```plaintext Request POST /pawn/guild/dismantle-chairman ``` | header | 型態 | 備註 | |------|----|----| | Bearer | str | 必要請由登入取得 Api_key (Bearer Token) | | 參數 | 型態 | 備註 | |----|----|----| | dismantle_chairman_id | int | 必要要解除的公會長會員 id | | sign | str | 必要加密後鑰匙 | ```plaintext Response ``` | code | 說明 | 備註 | |------|----|----| | 1 | 成功 | | ## 貢獻 ```plaintext Request POST /pawn/guild/contribute ``` | header | 型態 | 備註 | |------|----|----| | Bearer | str | 必要請由登入取得 Api_key (Bearer Token) | | 參數 | 型態 | 備註 | |----|----|----| | amount | decimal(14,4) | 必要異動額度 | | contribute_type| str | 預設 PG 贈禮類型 PG,TP | | sign | str | 必要加密後鑰匙 | ```plaintext Response ``` | code | 說明 | 備註 | |------|----|----| | 1 | 成功 | | ## 贈禮 ```plaintext Request POST /pawn/guild/donate ``` | header | 型態 | 備註 | |------|----|----| | Bearer | str | 必要請由登入取得 Api_key (Bearer Token) | | 參數 | 型態 | 備註 | |----|----|----| | amount | decimal(14,4) | 必要異動額度 | | contribute_type| str | 預設 PG 贈禮類型 PG,TP | | donate_user_id| int | 必要會員 u_id | | sign | str | 必要加密後鑰匙 | ```plaintext Response ``` | code | 說明 | 備註 | |------|----|----| | 1 | 成功 | | ## 查詢 PG TP 報表 ```plaintext Request POST /pawn/show-transaction ``` | header | 型態 | 備註 | |------|----|----| | Bearer | str | 必要請由登入取得 Api_key (Bearer Token) | | 參數 | 型態 | 備註 | |----|----|----| | end_make_time | int | 選填結束時間 Unix timestamp | | model| str | 預設 guild 查詢類型 guild,user | | start_make_time| int | 選填開始時間 Unix timestamp| | type| str | 預設 PG 查詢幣別 PG,TP | | sign | str | 必要加密後鑰匙 | ```plaintext Response ``` | code | 說明 | 備註 | |------|----|----| | 1 | 成功 | | | Data | 說明 | 備註 | |------|----|----| | T_id | 轉帳id 系統唯一 | | | Amount | 異動金額 | | | Amount_before | 變更前 | | | Amount_after | 變更後 | | | Make_time | 異動時間 | | | Type_in | 以下表格說明 | int | | Status | 狀態 | | | To_user_id | 收件者 u_id | | | To_name | 收件者暱稱 | | | From_user_id | 來自 u_id | | | From_guild_role | 來自公會職位 | | | From_name | 來自暱稱 | | | Model | 動作 | 只有 TP 有 | | Type_in for PG | 說明 | 備註 | |------|----|----| | 1 | 贈禮入金 | PG only | | 2 | 贈禮出金| PG only | | 3 | 捐獻近來 | PG only | | 4 | 捐獻出去| PG only | | 5 | 異動時間 | PG only | | Type_in for TP | 說明 | 備註 | |------|----|----| | 1 | 購買商品| TP only | | 2 | 反水| TP only | | 3 | 反擁| TP only | | 4 | 內轉| TP only | | 5 | 購買 NFT| TP only | | 6 | 提出 NFT 手續費| TP only | | 7 | 提出 NFT 手續費退還| TP only | | 8 | 贈禮轉出 | TP only | | 9 | 贈禮轉入 | TP only | | 10 | 捐獻轉入 | TP only | | 11 | 捐獻轉入 | TP only |