TaDa API 整合常見問題集


1. 登入與存取問題

1.1 Q: 為什麼某些時段無法進入遊戲?

A: 這通常是時區設定問題導致的金鑰驗證失敗。

解決方案:

  1. 檢查金鑰生成中的時區設定
  2. 確保 KeyG 使用 UTC-4 時區
  3. 驗證日期格式:yyMMd

正確格式範例:

2018/2/7  → 18027  (7號是7,不是07)
2018/2/18 → 180218

1.2 Q: 無法登入後台管理介面(Backend Office, BO)怎麼辦?

A: 後台登入問題通常有以下幾種原因:

1. 帳號密碼問題

  • 帳號: 使用您的 AgentId
  • 密碼: 預設與帳號相同

2. IP 地區限制

⚠️ 重要提醒
TaDa 不支援以下地區運營並封鎖相關 IP

封鎖地區清單:

地區 國家/地區
東亞 中國、香港、澳門、台灣、日本、韓國
東南亞 泰國、馬來西亞、菲律賓、新加坡、印尼、越南
南亞 孟加拉、印度

解決方案: 使用 VPN 連線至美國再嘗試登入

3. IP 白名單限制(錯誤代碼:10004)

  • 需要將登入端 IP 加入白名單
  • 請聯繫 TaDa 客服 (Service) 提供您的固定 IP
  • 建議使用固定 IP 的電腦進行登入

1.3 Q: 進入遊戲載入畫面出現 MSG 104 錯誤代碼

A: 此錯誤表示 IP 地區限制。

原因: 您的 IP 位址來自 TaDa 不支援的營運地區

解決方案: 使用 VPN 連線至美國等支援地區再嘗試登入


1.4 Q: 重新整理網頁後無法進入遊戲?

A: 這是正常的安全機制。

原因: LoginWithoutRedirect API 回傳的登入連結是 一次性使用

解決方案: 需要重新呼叫 API 取得新的登入連結


2. API 技術問題

2.1 Q: 必須提供哪些API?只要提供 auth, bet, cancelBet 這三個API就可以了嗎?

A: 是的,基本上只要提供這三個 API 就可以支援大部分遊戲。

基本 API 支援範圍:

  • Slot 遊戲:完全支援
  • Fish Game(捕魚遊戲):完全支援
  • Plinko 系列 FastGame:完全支援

例外情況:

  • 部分 FastGame:需要額外的 sessionBet API 才能支援
  • 範例遊戲:Mines、Limbo 等

建議作法:
如果技術條件允許,建議一併提供以下 API 以獲得完整支援:

這樣可以確保支援所有類型的 TaDa 遊戲。


2.2 Q: 請求營運商 API 有安全驗證嗎?

A: 是的(預設未開啟)。TaDa 提供 HTTP Basic Auth 驗證機制

設定步驟:

  1. 營運商提供 username 和 password 給 TaDa 客服 (Service) 設定
  2. 詳細實作方式請參考 API 文件「4.1.3 Response
  3. 詳細實作方式請參考 API 文件「附錄E - HTTP 驗證

2.3 Q: 投注 API 有重試機制嗎?

A: 是的,TaDa 支援投注重試機制。

設定方式:

  • 請聯繫 TaDa 客服 (Service) 或 TaDa 技術進行設定
  • 相關技術細節請參考 API 文件「4.2.6 重送注單

重試邏輯:

  • 當投注請求因網路問題失敗時自動重試
  • 可設定重試次數和間隔時間
  • 超過重試次數後會發送取消請求

3. 遊戲機制問題

3.1 Q: 為什麼捕魚遊戲收到的押注金額與實際不符?

A: 這是正常現象,屬於捕魚遊戲的特殊處理機制。

技術原理:

  • 原因: 捕魚遊戲押注頻率極高,為了減輕伺服器負擔
  • 處理方式: 系統每 1-3 秒彙整一次注單
  • 注單內容: 每筆注單都是該時間段內的押注/贏分總和

實際範例:

實際操作:玩家在2秒內進行了5次射擊,每次10元
系統發送:1筆注單,金額50元(5次×10元的總和)

4. 帳號管理問題

4.1 Q: 收到「This account was created by another agent」錯誤?

A: 這是帳號重複的問題。

原因: 在同一個遊戲廠商下,玩家帳號必須是唯一的

影響範圍: 即使是不同的 AgentId,也不能有相同的玩家帳號名稱

解決方案:

  1. 建議方案: 在玩家帳號前加上 AgentId 後綴
  2. 替代方案: 使用其他唯一識別規則(如加入數字編號)

5. 功能設定問題

5.1 Q: 如何設定遊戲內的返回大廳功能?

A: TaDa 提供三種返回大廳的方式:

方式一:直接關閉分頁(預設)

  • 無需額外設定
  • 玩家點擊返回時直接關閉遊戲視窗

方式二:返回指定網頁

  • LoginWithoutRedirect API 中帶入 HomeUrl 參數
  • 需要請 TaDa 客服 (Service) 協助設定

方式三:PostMessage 通訊

  • 透過 JavaScript PostMessage 與母頁面溝通
  • 需要請 TaDa 客服 (Service) 協助設定

5.2 Q: 遊戲內會有返回大廳按鈕嗎?

A: 返回大廳按鈕的顯示需要透過 TaDa 客服 (Service) 進行設定。