Widget for Exchange and Scoreboard
更新:
2023/1/05 新增 sport book, exchange 商戶優先集群區分
2023/12/27 Feature: score info solution
2023/12/5 後端 api- 商戶比分卡聯賽群設定, 改變比分卡排序敘述
2023/10/19 比賽優先順位 新增
2023/09/27: 後端邏輯 新增
2023/09/28: 比分卡Widget.後端 api 進行更改
比分卡顯示的所有賽事資訊由 SportRadar Summary API 提供，後端僅控制顯示的聯賽與比賽排序。
SR Summary API:
https://score.uni247.xyz/?event_id=41420487&summary=1&lang=th
語言有 th/en/vi/zh/hi
提供比賽的資訊：聯賽名稱、隊伍名稱、比分資訊、已進行時間
後端邏輯：
提供需要比分卡的比賽的 event_id, 回應資料已照既定規則排序
2023/09/27 新增:
新增 sort_type 來指定排序方式:
sort_type=classic
經典排序
sort_type=start_date
開始時間從小至大, 若開始時間一樣用 event_id 從小至大
不帶
經典排序
api:
透過 quote/vsb/overall-matches/light/v1/ 傳送值, 參考 swag
response schema:
{
"type": "object",
"properties": {
"status_code": {
"type": "integer"
},
"data": {
"type": "array",
"descriptions": "每個單位為一場比賽, 排序是 inplay 在最前面, 接著是否重要聯賽排序, 然後是根據 StartDate 經典排序, 最後根據 eventID 排序",
"items": {
"type": "object",
"properties": {
"tournament_id": {
"type": "string",
"description": "聯賽 ID, 協助開發檢核資料用"
},
"event_id": {
"type": "string",
"description": "用這個去拿對應比分卡"
},
"status": {
"type": "string",
"description": "比賽開始 or 還沒開始, 協助開發檢核資料用",
"enum": ["inplay", "notstarted"]
},
"time": {
"type": "string",
"description": "比賽開始時間, 協助開發檢核資料用",
"format": "date-time"
}
},
"required": [
"tournament_id",
"event_id",
"status",
"time"
]
}
}
},
"required": [
"status_code",
"data"
]
}
用 googlesheet 更新:
於 google sheet 可以更新需要比分卡的聯賽 ID, 系統會每三分鐘去 google sheet 拿取最新值加入服務。
值會在服務中存活六分鐘。也就是說從 google sheet 上刪除聯賽的話, 服務會在六分鐘後實現該聯賽的刪除。(2023/06/14)
google sheet 編寫邏輯, 系統只處理第一個 columns, 第一個 columns 放需要比分卡的所有聯賽, 所以其他地方可以隨便寫
比分卡Widget
外包由喜馬團隊製作，內嵌該元件至LuckySports。
外包串接文件 提供給外部網站外嵌檔案 2.0: https://polished-candy-369.notion.site/Widget-2-0-LS-scoreboard-ea3b7eaf2d264ed48925d598faf8ce96
2.1: https://polished-candy-369.notion.site/dbe71862493c4e659a3877356f4bd78f
前端改版邏輯：
將喜馬比分卡專案加入賠率訊源，賠率API由後端新增至quote/vsb/overall-matches/light/v1/
賠率先用mockdata進行，介面顯示調整(Part A./B./C.)
EX icon.svg-白色icon
EX-Black icon.svg-黑色icon
其他球種版型：
套色：
後端 api-比分資料:
提供用戶要顯示比分卡相關資訊的 event_id, 讓用戶可透過別的api 拿比分相關資料。
每個event_id 都會提供對應的 market_id + 賠率, 顯示於比分卡中。
swag: https://webapi.ckex.xyz/dev-f/quote/swagger/index.html#/auth-user/ListVsbOverallMatchesOnlyEvent
request data
event_type_id
string
球種 id
market_type
string
response 攜帶的盤口種類選擇。
詳細看: 新增: Exchange match odds market for cricket (2023/11/23)
sort_type
string
排序方式:
enum:
classic
start_date
count
int
response最多的單位個數
len(response.data) <= count
會根據賽事重要程度捉取最重要的 count 場比賽。
比賽優先捉取順位
根據request 要求數量, 以比賽的優先捉取順位進行捉取, 直到符合要求數量
若 req.sort_type 是 start_date 且 商戶有設定聯賽優先順序至cloudstorage.
商戶設定的聯賽優先:
商戶可以設定他想要的聯賽群, 此聯賽群會優先提供比分卡。 用 後端api-商戶聯賽群設定。
系統服務預設的聯賽集群
else
only 系統服務預設的聯賽集群
比賽排序:
根據request.sort_type 不同有不同排序
classic:
比賽狀態-> 聯賽優先順位 -> 賽事開始時間 -> event_id
start_date:
賽事開始時間 -> event_id
response schema
status_code
int
data
[]data_obj
data_obj
tournament_id
string
event_id
string
status
string
比賽狀態
time
string
format: timestamp to second
example: 2023-09-29T19:00:00Z
比賽開始時間
m
Market
response 新增 M 的 field
M 為一個 Market 的 object, 如同 overall_match.Response.c_products[i] 的格式
2023/09/28 將 M 的 schema 輕量為:
Market
market_id
string
盤口 id
product
[]Product
盤口擁有的項目
Product
product_id
string
項目 id
status
string
該項目狀態
enum:
close
open
suspended
o
float
賠率
賠率數值所在為 responseData.data[i].m[i].product[i].o
賠率於比分卡所在位置(為 1 or X or 2), 用product_id (outcome_id)對應, 參考下方:
event_type_id 1; 抽取 1_ 盤口;
1
1
2
X
3
2
event_type_id 4;
抽取 340_盤口 or 11_盤口 ;
優先順位是: 340_, 11_
4
1
5
2
其他的 event_type 還沒有指定要呈現的盤口
如果 該比賽不存在 首頁呈現盤口, 則 response.M 為 `{}`。
example response
有盤口的資料 (event_type_id=1, count=3):
{ "status_code": 200, "data": [ { "tournament_id": "sr:tournament:18", "event_id": "41887813-e", "status": "notstarted", "time": "2023-09-29T19:00:00Z", "m": { "market_id": "1_51647013", "product": [ { "product_id": "1", "status": "open", "o": 3.05 }, { "product_id": "2", "status": "open", "o": 3.5 }, { "product_id": "3", "status": "open", "o": 2.4 } ] } }, { "tournament_id": "sr:tournament:17", "event_id": "41762961-e", "status": "notstarted", "time": "2023-09-30T11:30:00Z", "m": { "market_id": "1_51348677", "product": [ { "product_id": "1", "status": "open", "o": 2.52 }, { "product_id": "2", "status": "open", "o": 3.95 }, { "product_id": "3", "status": "open", "o": 2.64 } ] } }, { "tournament_id": "sr:tournament:18", "event_id": "41887817-e", "status": "notstarted", "time": "2023-09-30T11:30:00Z", "m": { "market_id": "1_51953142", "product": [ { "product_id": "1", "status": "open", "o": 2.96 }, { "product_id": "2", "status": "open", "o": 3.7 }, { "product_id": "3", "status": "open", "o": 2.36 } ] } } ] }
有盤口資料 (event_type=4, count=3)
{ "status_code": 200, "data": [ { "tournament_id": "sr:tournament:40981", "event_id": "43699381-e", "status": "started", "time": "2023-09-28T01:00:00Z", "m": { "market_id": "340_52702376", "product": [ { "product_id": "4", "status": "open", "o": 1.28 }, { "product_id": "5", "status": "open", "o": 3.9 } ] } }, { "tournament_id": "sr:tournament:40981", "event_id": "43699365-e", "status": "notstarted", "time": "2023-09-28T06:00:00Z", "m": { "market_id": "340_52701830", "product": [ { "product_id": "4", "status": "open", "o": 12.5 }, { "product_id": "5", "status": "open", "o": 1.04 } ] } }, { "tournament_id": "sr:tournament:40747", "event_id": "43048229-e", "status": "notstarted", "time": "2023-09-28T07:30:00Z", "m": { "market_id": "340_52304209", "product": [ { "product_id": "4", "status": "open", "o": 1.72 }, { "product_id": "5", "status": "open", "o": 2.18 } ] } } ] }
沒盤口的資料
{
"status_code": 200,
"data": [
{
"tournament_id": "sr:tournament:486",
"event_id": "43656037-e",
"status": "notstarted",
"time": "2023-09-14T00:00:00Z",
"m": {}
},
{
"tournament_id": "sr:tournament:486",
"event_id": "43656041-e",
"status": "notstarted",
"time": "2023-09-14T02:00:00Z",
"m": {}
}
]
}
後端 api- 商戶比分卡聯賽群設定
商戶設定自己想要的比分卡聯賽集群, 集群中的聯賽的比賽比分卡會優先顯示於前端。
邏輯:
若商戶設定過優先集群, 怎再取賽事時, 會有先取商戶所指定的聯賽集群。再取系統預設的聯賽集群。 ( 集群間有優先順序, 集群內沒有 )
為了與舊版本相容，設定空白為order_class的選項之一。
url: /quote/merchant/tournaments/
權限: header 帶 商戶 token
data:
tournaments
type: []string
陣列中的每個字串為聯賽ID ex: sr:tournament:3
這個陣列代表商戶想要設定的聯賽集群
get 得取商戶的聯賽表 swag
request body:
order_class
string
提供sportbook, exchange和空白三個選項
分別對應該商戶創建的聯賽表
response:
200:
InStore
[]string
tournaments
在靜態存儲中的聯賽集群
InService
[]string
tournaments
在服務中暫存的聯賽集群
post 更新商戶的聯賽表 swag
商戶透過這個 api 將 想要的聯賽集群更新至 cloud storage。 在cloud storage 會以 json file 的個是進行存放。
request body:
tournaments
[]string
tournaments
order_class
string
提供sportbook, exchange和空白三個選項
request body example:
{
tournaments: ["sr:tournament:1", "sr:tournament:2"]
}
response
201
cloud storage file path:
目前並存三種路徑模式。
merchant_document_for_service/score_card_tournament/{merchant_code}
在 下一版本前, 一個商戶只會有一種優先集群, 並沒做類別區分。 所以單用 merchant_code 做檔案名稱的命名。
以下為 2023/1/04 後版本, 優先集群設定同商戶下會有不同的集群。
merchant_document_for_service/score_card_tournament/{merchant_code}_sportbook
商戶下 sport book 的優先集群檔
merchant_document_for_service/score_card_tournament/{merchant_code}_exchange
商戶下 exchange 的優先集群檔
Exchange Widget
新增: Exchange match odds market for cricket (2023/11/23)
出圖： Widget- Exchange Odds board
欄位：
套色：
後端 api:
swag: https://webapi.ckex.xyz/dev-f/quote/swagger/index.html#/auth-user/ListVsbOverallMatchesOnlyEvent
新增 market_type 參數。
market_type 選項
目前 market_type=match_odds 只提供板球 (event_type_id=4)。 若帶其他event_type 會直接給 sport book 盤口與賠率(在此更新前的版本)。
market_type=match_odds 情況下, 回傳資料會有新增欄位:
新增位置: data[i].m.product[i]
lo
lay 的賠率
bq
back 的量
lq
lay的量
data example:
request GET
response 200:
{"status_code":200,"data":[{"tournament_id":"sr:tournament:38239","event_id":"45600056-e","status":"notstarted","time":"2023-11-23T07:30:00Z","m":{"market_id":"340_56891931","product":[{"product_id":"4","status":"open","o":1.69,"lo":1.71,"bq":"5917","lq":"17100"},{"product_id":"5","status":"open","o":2.4,"lo":2.46,"bq":"4166","lq":"24600"}]}},{"tournament_id":"sr:tournament:21570","event_id":"42343671-e","status":"notstarted","time":"2023-11-23T08:10:00Z","m":{"market_id":"340_56725107","product":[{"product_id":"4","status":"open","o":1.77,"lo":1.79,"bq":"5649","lq":"17900"},{"product_id":"5","status":"open","o":2.26,"lo":2.3,"bq":"4424","lq":"23000"}]}},{"tournament_id":"sr:tournament:36027","event_id":"45560430-e","status":"notstarted","time":"2023-11-23T09:30:00Z","m":{"market_id":"340_56895182","product":[{"product_id":"4","status":"open","o":2.06,"lo":2.1,"bq":"4854","lq":"21000"},{"product_id":"5","status":"open","o":1.91,"lo":1.93,"bq":"5235","lq":"19300"}]}}]}
Last updated